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-FileGRAF_WATCHBOX(tree,obj,in_state,out_state)

tree, obj, instate, out_state: iexp

This function (which really belongs in the Object Library) monitors an object
in a tree while a mouse button is pressed, checking whether the mouse pointer
is inside it or outside. When the button is released, the status of the object
takes one of two specified values (normal selected/normal), depending on
whether the pointer was located inside the object, or outside.

Returns 1 if the mouse pointer was inside the object when the button was
released, or 0 if it was outside.

    tree      - Address of the object tree.
    obj       - Number of the object to be monitored.
    in_state  - Status (OB_STATE) to be given to the object if the mouse is
                found to be within it.
    out_state - Status (OB_STATE) to be given to the object if the mouse
                pointer is found to be outside it. The appropriate bit
                allocation is found under OB_STATE().

graf_watchbox()+