/ 
IUP-0.305
River stage zero No dependents
/ IUP::Fill

NAME

IUP::Fill - [GUI element] dynamically occupies empty spaces always trying to expand itself

DESCRIPTION

Creates a Fill composition element, which dynamically occupies empty spaces always trying to expand itself. Its parent must be an IUP::Hbox or an IUP::Vbox. If an EXPAND is set on at least one of the other children of the box, then the Fill is ignored.

It does not have a native representation.

USAGE

CREATION - new() method

$fill = IUP::Fill->new( SIZE=>30 );

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

NOTE: You can pass to new() other ATTRIBUTE=>'value' or CALLBACKNAME=>\&func pairs relevant to this element - see IUP::Manual::02_Elements.

ATTRIBUTES

For more info about concept of attributes (setting/getting values etc.) see IUP::Manual::03_Attributes. Attributes specific to this element:

EXPAND

(non inheritable)

Ignored. If User size is not defined, then when inside a IUP::Hbox EXPAND is HORIZONTAL, when inside a IUP::Vbox EXPAND is VERTICAL. If User size is defined then EXPAND is NO.

SIZE / RASTERSIZE (non inheritable)

Defines the width, if inside a IUP::Hbox, or the height, if it is inside a IUP::Vbox. When consulted behaves as the standard SIZE/RASTERSIZE attributes. The standard format "wxh" can also be used, but width will be ignored if inside a IUP::Vbox and height will be ignored if inside a IUP::Hbox (since iup-3.3).

WID

(read-only)

Returns -1 if mapped.

The following common attributes are also accepted:

EXAMPLES

The element IUP::Fill is used in the following sample scripts:

SEE ALSO

IUP::Hbox, IUP::Vbox

The original doc: iupfill.html