Definition: |
include pGUI.e
Ihandle ih = IupRadio(Ihandln child=NULL, string attributes="", sequence data={}) |
Description: |
Creates a void container for grouping mutually 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. child: Identifier of an interface element. Usually it is an IupVbox or IupHbox containing the toggles associated to the radio. It can be NULL. For more information on the attributes and data parameters see IupSetAttributes. Returns: the identifier of the created element. |
Notes: |
The radio can be created with no elements and filled dynamically using IupAppend() or IupInsert().
A toggle that is a child of an IupRadio automatically receives a name when its is mapped into the native system. Currently IupFlatButton with TOGGLE=YES, IupToggle, and IupGLToggle are affected when inside a IupRadio. |
Attributes: | |
EXPAND | (non inheritable) The default value is "YES". |
VALUE | (non inheritable) name identifier of the active toggle. The name is set by means of IupSetHandle. When consulted if the toggles are not mapped into the native system the return value may be NULL 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 NULL or invalid. (since 3.0) |
WID | (read-only) returns -1 if mapped. |
also | FONT, POSITION, CLIENTSIZE, CLIENTOFFSET, MINSIZE, MAXSIZE, VISIBLE: also accepted. |