Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.9.12  wind_xget                                                  TOS

 Name:         »Get window« - Obtain properties of a window, extended 
               version.

 Opcode:       104

 Syntax:       int16_t wind_xget ( int16_t wi_ghandle, int16_t 
               wi_gfield, int16_t *wi_gw1, int16_t *wi_gw2, int16_t 
               *wi_gw3, int16_t *wi_gw3 int16_t *wo_gw2, int16_t 
               *wo_gw3, int16_t *wo_gw3 );

 Description:  Depending on the parameters passed, the call wind_xget 
               returns information about various properties of the 
               window with the ID wi_ghandle. The following apply for 
               wi_gfield:

               Overview of all subfunctions; numbers in brackets 
               represent the wi_gfield mode:

                WF_CALCF2W (42)
                        This mode will take an arbitrary FULL area, 
                        and return the corresponding WORK area.

                        The presence should be checked for using 
                        appl_getinfo (opcode 11).

                WF_CALCW2F (43)
                        This mode will take an arbitrary WORK area, 
                        and return the resulting FULL area of the 
                        window in question.

                        The presence should be checked for using 
                        appl_getinfo (opcode 11).

                WF_FIRSTAREAXYWH (13)
                        wi_gw1, wi_gw2, wi_gw3 and wi_gw4 define a 
                        clipping area, and the AES may optimize the 
                        list of rectangles that is returned by 
                        WF_FIRSTAREAXYWH and WF_NEXTXYWH.

                        The presence should be checked for using 
                        appl_getinfo (opcode 11).

 Return value: An error has arisen only if the value 0 is returned.

 Availability: XaAES as of 2004-12-14

 Group:        Window library

 See Also:     Binding   wind_get   wind_set   Subfunctions overview