Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileW_HAND(#n)
W_INDEX(#hd)

n, hd: aexp

W_HAND() returns the GEM 'handle' (identification number) of the window whose
'channel number' was specified in 'n' (1 to 4).

W_INDEX() performs the inverse function and returns the window number (1 to 4)
for the specified GEM handle (1 to ?).

Note: The window number is the value used in the simple window control
      commands. The GEM handle is a different value (used by AES) which refers
      to the same window. The GEM handle should be used to specify a
      particular window when using the AES routines.

Example:

    OPENW 2
    PRINT W_HAND(#2)
    ~INP(2)
    CLOSEW #2

--> Prints the AES 'handle' of the window numbered 2 on the screen. Pressing a
    key terminates the program.

Memo: W_HAND() does not return the desktop handle correctly.
      Negative offsets result in access below the table.
      Too large of values not checked, results in access beyond the table.

      W_INDEX() returns 0 for any AES handle it cannont find.

      These problems occur in the editor as well as the library.

wind_get()+