VkRadioGroup(3x)

NAME
     VkRadioGroup - 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 DESCRIPTIONS
   valueChanged()
           virtual void valueChanged(Widget w, XtPointer callData);
          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