Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileform_button()
Graphics Library
graf_watchbox()                                                         AES

Syntax

WORD graf_watchbox( tree, obj, instate, outstate )
OBJECT *tree;
WORD obj, instate, outstate;

Function       graf_watchbox() modifies the given state of a specified
               object depending on whether the pointer is within the
               bounds of  the object or outside the bounds of the object
               as long as the left mouse button is held down.

Opcode         75 (0x4B)

Availability   All AES versions.

Parameters     tree is a pointer to the ROOT object of the tree which
               contains the object you wish to watch. obj is the object
               index of the object to watch.
               instate is the ob_state (see objc_change()) to apply while
               the mouse is inside of the bounds of the object.
               outstate is the ob_state to apply while the mouse is
               outside of the bounds of the object.

Binding        intin[0] = 0;
               intin[1] = obj;
               intin[2] = instate;
               intin[3] = outstate;

               addrin[0] = tree;

               return crys_if(0x4B);

Return Value   graf_watchbox() returns a 0 if the mouse button was
               released outside of the object or a 1 if the button was
               released inside of the object.

Comments       As this call returns when the mouse button is released, it
               should only be made when the mouse button is depressed.
               This call is used internally by form_button() and form_do()
               and is usually only necessary if you are replacing one of
               these handlers.

See Also       form_button()

Group          Graphics Library