IupGLSizebox (since 3.11)

Creates a void container that allows its child to be resized. Allows expanding and contracting the child size in one or two directions. It inherits from IupGLSubCanvas. It exists only inside an IupGLCanvasBox.


Ihandle* IupGLSizebox(Ihandle* child); [in C]
iup.glsizebox{child: ihandle} -> (elem: ihandle) [in Lua]
glsizebox(child) [in LED]

child: Identifier of an interface element which will receive the box. It can be NULL (nil in Lua), not optional in LED.

Returns: the identifier of the created element, or NULL if an error occurs.


The IupGLScrollBox element handle all attributes defined for a IupGLSubCanvas control.

FORECOLOR: Changes the color of the bar handler. The value should be given in "R G B" color style. Default: "192 192 192".

RESIZERS: Indicates the direction of the resize. Possible values are "VERTICAL", "HORIZONTAL", or "BOTH". Default: "BOTH". The handler is always placed at the right/bottom of its child.

EXPAND (non inheritable): The default value is "YES".



The control inside the IupGLSizeBox will have its User size changed. See the Layout Guide for mode details on sizes.

IupGLSizeBox can make the layout to be resized larger than the IupGLCanvasBox size so some controls will be positioned outside the box area at right or bottom. In fact this is part of the dynamic layout default reposition of controls inside the box. See the IupRefresh function. The IUP layout does not have a maximum limit only a minimum, except if you use the MAXSIZE common attribute.

The box can be created with no elements and be dynamic filled using IupAppend or IupInsert.


Browse for Example Files