You may return to the Cvo Object Documenation Index from this document. This document contains the following sections describing the Cvo_RadioBox object:
Cvo_RadioBox
Cvo_Window
#include
<Cvo/RadioBox.h++>
new
Cvo_RadioBox ( char *resource_name,
{ Cvo_Object *parent | Display *display },
Cvo_RadioBoxList *list )
A Cvo_RadioBox object contains a series of Cvo_SquareToggleButton objects associated together as a radio. Only one toggle is allowed down at any given time.
The Cvo_RadioBoxList *list argument defines the list of toggles that should be in the Cvo_RadioBox. The list argument should be a NULL terminated array of Cvo_RadioBoxList structures. This object will fill the Cvo_Object *toggle pointers in the Cvo_RadioBoxList *list array with Cvo_SquareToggleButton object pointers.
This object defines the following member functions in addition to those defined by its parent and ancestor objects.
RequireSelection (
[ BOOL value ] )
This function forces the requirement that there is always one of
the radio buttons selected. (Or, if value is specified and is
False
, remove this requirement).
This object defines the following Cvo Events in addition to those defined by its parent and ancestor objects.
CvoRadioBoxSelectedEvent
struct
Cvo_RadioBoxSelectedEvent
int index,
void *data
This event is generated when an item is selected. The index value is the array index of the item selected and data is the value which was associated with that item.
CvoRadioBoxDeselectedEvent
struct
Cvo_RadioBoxSelectedEvent
int index,
void *data
This event is generated when an item is deselected. The index value is the array index of the item deselected and data is the value which was associated with that item.
See the example source code for an example of how to use this object.
See the legend for information about the conventions used in this documentation.