VkRadioGroup(3x)					      VkRadioGroup(3x)

NAME    [Toc]    [Back]

     VkRadioGroup - Support for	radio behavior within any set of toggle
     buttons

INHERITS FROM    [Toc]    [Back]

     VkWidgetList

HEADER FILE    [Toc]    [Back]

     #include <Vk/VkRadioGroup.h>

PUBLIC PROTOCOL	SUMMARY
   Constructor/Destructor
	   VkRadioGroup(void);
	   virtual  ~VkRadioGroup(void);

PROTECTED PROTOCOL SUMMARY    [Toc]    [Back]

	   virtual void	valueChanged(Widget w, XtPointer callData);

CLASS DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

   valueChanged()
	   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()    [Toc]    [Back]
	   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    [Toc]    [Back]

   Inherited from VkWidgetList
	  widgetDestroyed(), VkWidgetList(), ~VkWidgetList(), remove(),
	  remove(), removeFirst(), removeLast(), exists(), size(),
	  operator[](),


CLASSES	USED BY	THIS CLASS
     VkComponent, VkWidgetList

SEE ALSO    [Toc]    [Back]

     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


									PPPPaaaaggggeeee 2222