VkRadioGroup(3x)VkRadioGroup(3x)NAMEVkRadioGroup - Support for radio behavior within any set of toggle
buttons
INHERITS FROM
VkWidgetList
HEADER FILE
#include <Vk/VkRadioGroup.h>
PUBLIC PROTOCOL SUMMARY
Constructor/Destructor
VkRadioGroup(void);
virtual ~VkRadioGroup(void);
PROTECTED PROTOCOL SUMMARY
virtual void valueChanged(Widget w, XtPointer callData);
CLASS DESCRIPTION
Motif supports collections of toggle buttons that exhibit one-of-many
behavior by placing all related toggle buttons in a RadioBox widget.
This is adequate in many cases, but it is also useful to have buttons
that are geographically dispersed throughout an applications exhibit this
same behavior. The VkRadioGroup supports applications that need this
behavior.
The VkRadioGroup class is derived from VkWidgetList and allows
applications to add individual widgets to a "group". The VkRadioGroup
class limits members of the group to XmToggleButton and
XmToggleButtonGadget widgets. Within any group, only a single widget may
be selected at any one time. Widgets may be added regardless of their
position in the application's widget hierarchy.
The VkRadioGroup supports a virtual member function valueChanged() that
is called when any widget belonging to the group changes state.
Applications can choose to derive a new class from VkRadioGroup and
override this function to receive such notifications, or they may rely on
Xt callback functions registered directly with the toggle button widgets.
Note that membership in a VkRadioGroup is not exclusive; a widget could
potentially belong to multiple groups at once.
FUNCTION DESCRIPTIONSvalueChanged()
virtual void valueChanged(Widget w, XtPointer callData);
Page 1
VkRadioGroup(3x)VkRadioGroup(3x)
This virtual, protected function is called when any member of a
VkRadioGroup changes state. Derived classes can override this
function to be notified of state changes.
VkRadioGroup()VkRadioGroup(void);
Initialize an empty VkRadioGroup object.
~VkRadioGroup()
virtual ~VkRadioGroup(void);
Clean up all memory allocated by a VkRadioGroup object. Deleting a
VkRadioGroup object does not destroy the widgets contained by the
group.
INHERITED MEMBER FUNCTIONS
Inherited from VkWidgetList
widgetDestroyed(), VkWidgetList(), ~VkWidgetList(), remove(),
remove(), removeFirst(), removeLast(), exists(), size(),
operator[](),
CLASSES USED BY THIS CLASS
VkComponent, VkWidgetList
SEE ALSO
VkWidgetList, VkComponent
ViewKit Programmer's Guide
The X Window System, DEC Press, Bob Sheifler and Jim Gettys
The X Window System Toolkit, DEC Press, Paul Asente and Ralph Swick
The OSF/Motif Programmers Reference, Prentice Hall, OSF
Page 2
