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-Filegraf_movebox()
Graphics Library
graf_slidebox()                                                         AES

Syntax

WORD graf_slidebox( tree, parent, child, orient )
OBJECT *tree;
WORD parent, child, orient;

Function       graf_slidebox() allows the user to slide a child object
               within the bounds of its parent. It is often used to
               implement slider controls.

Opcode         76 (0x4C)

Availability   All AES versions.

Parameters     tree is pointer to the object tree containing the child and
               parent objects.
               parent is the object index of an object which bounds the
               movement of the child. child is the object index of the
               object which can be moved within the bounds of parent.
               orient specifies the orientation of the allowed movement.
               0 is horizontal (left-right), 1 is vertical (up-down).

Binding        intin[0] = parent;
               intin[1] = child;
               intin[2] = orient;

               addrin[0] = tree;

               return crys_if(0x4C);

Return Value   The function returns a value specifying the relative offset
               of the child within the parent as a number between 0 and
               1000.

Comments       This call can be used easily with sliders built into
               dialogs by making the slider bar a TOUCHEXIT and calling
               this function when it is clicked. This call should only be
               made when the mouse button is depressed as it returns when
               it is released.

See Also       graf_movebox()

Group          Graphics Library