# IupRadio

Definition: | include pGUI.e Ihandle ih = IupRadio(Ihandln child=NULL, string attributes="", dword_seq args={})
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 args parameters see IupSetAttributes. Returns: the identifier of the created element.
pwa/p2js: | Supported, but see +x? markers on individual attributes and callbacks.
Notes: | The radio can be created with no elements and filled dynamically using IupAppend() or IupInsert(). Note that previous statement actually refers to replacing a single initially NULL child; multiple (visible) elements would in fact be added to the child. 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, NAME, POSITION, CLIENTSIZE, CLIENTOFFSET, MINSIZE, MAXSIZE, VISIBLE: also accepted.