NAME

IUP::Radio - [GUI element] container for grouping mutual exclusive toggles (radiobutton)

DESCRIPTION

Creates a void container for grouping mutual exclusive toggles. Only one of its descendent toggles will be active at a time. The toggles can be at any composition.

It does not have a native representation.

USAGE

CREATION - new() method

$radio = IUP::Radio->new( child=>$box );

child: (named parameter) Reference to an interface element. Usually it is a IUP::Vbox or an IUP::Hbox containing the toggles associated to the radio. It can be undef.

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)

The default value is "YES".

VALUE

(non inheritable)

Name identifier of the active toggle. The name is set by means of SetName. In Lua(XXX) you can also use the element reference directly. XXX-check-this When consulted if the toggles are not mapped into the native system the return value may be undef or invalid.

VALUE_HANDLE

(non inheritable)

Changes the active toggle. The value passed must be the handle of a child contained in the radio. When consulted if the toggles are not mapped into the native system the return value may be undef or invalid.

WID

(read-only)

Returns -1 if mapped.

The following common attributes are also accepted:

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

NOTES

The radio can be created with no elements and be dynamic filled using Append or Insert.

EXAMPLES

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

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

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

• 0-basic/layoutdialog.pl - IUP::LayoutDialog example

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

• 0-basic/toggle.pl - IUP::Toggle example

• 1-apps/app-mdi.pl - IUP app example

• 1-apps/app-sample1.pl - example used for screenshot - IUP.pod

• 1-apps/app-sample2.pl - xxxTODO xxx some better callback

• 1-apps/app-simple-demo.pl - example used for screenshot - IUP.pod

The original doc: iupradio.html