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.12.11  graf_watchbox                                             TOS

 Name:         »Graphics watch box« - Select an object and supervise 
               mouse movements referring to this object.

 Opcode:       75

 Syntax:       int16_t graf_watchbox ( OBJECT *gr_wptree, int16_t 
               gr_wobject, int16_t gr_winstate, int16_t gr_woutstate 
               );

 Description:  The call graf_watchbox sets the status of an object, 
               depending on the position of the mouse pointer (whether 
               it is within or outside the bounds of the object) while 
               the left mouse button is held down. The following 
               apply:

                Parameter    Meaning

                gr_wptree    Address of root object of object tree
                gr_wpobject  Index of the object to watch
                gr_winstate  Object status when the mouse pointer is 
                             within the boundary:
                              NORMAL    (0x0000) 
                              SELECTED  (0x0001) 
                              CROSSED   (0x0002) 
                              CHECKED   (0x0004) 
                              DISABLED  (0x0008) 
                              OUTLINED  (0x0010) 
                              SHADOWED  (0x0020) 

                gr_woutstate Object status when the mouse pointer is 
                             outside the boundary:

               Note: The function returns when the mouse button is 
               released, so it should only be made while the button is 
               depressed.

 Return value: The function returns the position of the mouse pointer 
               at the release of the button (0 = outside the object 
               boundary, 1 = inside the boundary).

 Availability: All AES versions.

 Group:        Graphics library

 See Also:     Binding   graf_wwatchbox   OBJECT