Definition: |
include pGUI.e
Ihandle ih = IupScrollBox(Ihandln child=NULL, string attributes="", sequence data={}) |
Description: |
Creates a native container that allows its child to be scrolled. It inherits from IupCanvas.
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 IupScrollBox 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 filled dynamically using IupAppend() or IupInsert(). Inherits all attributes and callbacks of the IupCanvas, but redefines a few attributes. |
Attributes: | |
BGCOLOR | will always use the background color of the native parent. |
BORDER | (creation only): it is always "NO". |
CHILDOFFSET |
Allows the position offset for the child to be specified. Available for native containers only. It will not affect the natural size, and allows to position controls outside the client area. Format "dxxdy", where dx and dy are integer values corresponding to the horizontal and vertical offsets, respectively, in pixels. Default: 0x0. |
EXPAND | (non inheritable) The default value is "YES". |
SCROLLBAR | (creation only): the default value is "YES". |
CANFOCUS | is set to NO. |
also | CLIENTSIZE: also accepted. |
Example: |
![]() |