NAME

IUP::Cbox - [GUI element] container for position elements in absolute coordinates

DESCRIPTION

Creates a void container for position elements in absolute coordinates. It is a concrete layout container.

It does not have a native representation.

The IUP::Cbox is equivalent of a IUP::Vbox or IUP::Hbox where all the children have the FLOATING attribute set to YES, but children must use CX and CY attributes instead of the POSITION attribute.

USAGE

CREATION - new() method

 #standard way
 my $cbox = IUP::Cbox->new( child=>[$elem1, $elem2], ANYATTRIBUTE=>'any value' );
 
 #or with just a single child
 my $cbox = IUP::Cbox->new( child=>$elem, ANYATTRIBUTE=>'any value' );
 
 #or with just 1 parameter (arrayref)
 my $cbox = IUP::Cbox->new( [$elem1, $elem2] );
 
 #or with just 1 parameter (reference to child elements)
 my $cbox = IUP::Cbox->new( $elem );

child: (named parameter) List of the references to elements (or just a single element) that will be placed in the box. It can be ommited (see note below).

Returns: The reference to the created element, or udnef 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.

NOTE: IUP::Cbox can be created with no elements (no child params passed to new() constructor) and be dynamic filled later using $element->Append() and/or $element->Insert() methods.

ATTRIBUTES

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

CX, CY

(non inheritable) (at children only)

Position in pixels of the child relative to the top-left corner of the box. Must be set for each child inside the box.

EXPAND

(non inheritable)

The default value is "YES".

SIZE / RASTERSIZE (non inheritable)

Must be defined for each child. If not defined for the box, then it will be the bounding box that includes all children in their position.

WID

(read-only)

returns -1 if mapped.

The following common attributes are also accepted:

• FONT, CLIENTSIZE, CLIENTOFFSET, POSITION, MINSIZE, MAXSIZE

EXAMPLES

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

• 0-basic/cbox.pl - IUP::Cbox example

SEE ALSO

IUP::Vbox, IUP::Hbox

The original doc: iupcbox.html