IupGLScrollBox

Definition: include pGUI.e

Ihandle ih = IupGLScrollBox(Ihandln child=NULL, string attributes="", sequence data={})
Description: Creates an embedded OpenGL container that allows its child to be scrolled.
It inherits from IupGLSubCanvas. It exists only inside an IupGLCanvasBox.

child: Identifier of an interface element which will receive the box. It can be NULL.
For more information on the attributes and data parameters see IupSetAttributes.

Returns: the identifier of the created element.
Notes: The box allows the application to create a virtual space for the dialog that is actually larger than the visible area.
The current size of the box defines the visible area.
The natural size of the child (and its children) defines the virtual space size.
So the IupGLScrollBox does not depend on its child size or expansion, and its natural size is always 0x0.

The user can move the box contents by dragging the background. Also the mouse wheel scrolls the contents vertically.

The box can be created with no elements and be dynamic filled using IupAppend() or IupInsert.
Attributes: The IupGLScrollBox element handle all attributes defined for a IupGLSubCanvas control.

It contains automatic scrollbars that are shown or hidden accordingly if the child natural size fits the client size.
These are the same as the standard SCROLLBAR settings, except that X/YAUTOHIDE is not supported (effectively fixed at YES) and hence neither are X/YHIDDEN, and the defaults are 10 and 100 rather than 0.1 and 1.0. (PL: It may be worth checking that; I am not certain whether the documentation this is based on was deliberately duplicated to be different, or needlessly duplicated and accidentally out of date.)
EXPAND (non inheritable) The default value is "YES".
POSX Position of the thumb in the horizontal scrollbar. Default: "0.0". DX is the visible horizontal area and XMAX is set to the child natural width.
POSY Position of the thumb in the vertical scrollbar. Default: "0.0". DY is the visible vertical area and YMAX is set to the child natural height.
BACKCOLOR (non inheritable) color used as background. Can have an alpha component. Default: "200 225 245". Used instead of BGCOLOR to avoid inheritance problems.
FORECOLOR (non inheritable) handler and arrow color. Can have an alpha component. Default: "110 210 230". Used instead of FGCOLOR to avoid inheritance problems.
HIGHCOLOR (non inheritable) handler and arrow color when highlight. Default: "90 190 255".
PRESSCOLOR (non inheritable) handler and arrow color when pressed. Default: "50 150 255".
SCROLLBARSIZE The width of the vertical scrollbar or the height of the horizontal scrollbar. Default: 11.
also CLIENTSIZE, CLIENTOFFSET: also accepted.