kmx > IUP-0.101 > IUP::Radio

Download:
IUP-0.101.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source   Latest Release: IUP-0.202

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 or reference to the active toggle element. When consulted if the toggles are not mapped into the native system the return value may be undef or invalid.

ZZZ-test-this(reading the value)

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:

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:

The original doc: iupradio.html

syntax highlighting: