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:

• FONT, POSITION, MINSIZE, MAXSIZE

EXAMPLES

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

• 0-basic/button.pl - IUP::Button example

• 0-basic/canvas2.pl - IUP::Canvas example

• 0-basic/colorbrowser.pl - IUP::ColorBrowser example

• 0-basic/fill.pl - IUP::Fill Example

• 0-basic/frame1.pl - IUP::Frame Example

• 0-basic/gauge.pl - IUP::Gauge example

• 0-basic/hbox.pl - IUP::Hbox example

• 0-basic/image.pl - IUP::Image example

• 0-basic/plot_advanced.pl - Plot controls

• 0-basic/pre-dialogs.pl - IUP::Expander example

• 0-basic/progressbar2.pl - IUP::ProgressBar example

• 0-basic/progressbar3.pl - IUP::ProgressBar example

• 0-basic/radio.pl - IUP::Radio example

• 0-basic/tabs3.pl - IUP::Tabs example

• 0-basic/tree_set_attrs.pl - IUP::Tree example (attributes)

• 0-basic/vbox.pl - IUP::Vbox example

• 0-basic/zbox.pl - IUP::Zbox example

• 1-apps/app-plot-demo.pl - dials for zooming

SEE ALSO

IUP::Hbox, IUP::Vbox

The original doc: iupfill.html