


XmToggleButton(3X)					   XmToggleButton(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTToogggglleeBBuuttttoonn - The ToggleButton widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//TToogggglleeBB..hh>>

DESCRIPTION
  ToggleButton sets nontransitory state	data within an application.  Usually
  this widget consists of an indicator (square or diamond) with	either text
  or a pixmap on one side of it.  However, it can also consist of just text
  or a pixmap without the indicator.

  The toggle graphics display a	11--ooff--mmaannyy or NN--ooff--mmaannyy selection state.	 When
  a toggle indicator is	displayed, a square indicator shows an NN--ooff--mmaannyy
  selection state and a	diamond	indicator shows	a 11--ooff--mmaannyy selection state.

  ToggleButton implies a selected or unselected	state.	In the case of a
  label	and an indicator, an empty indicator (square or	diamond	shaped)	indi-
  cates	that ToggleButton is unselected, and a filled indicator	shows that it
  is selected.	In the case of a pixmap	toggle,	different pixmaps are used to
  display the selected/unselected states.

  The default behavior associated with a ToggleButton in a menu	depends	on
  the type of menu system in which it resides.	By default, BBSSeelleecctt controls
  the behavior of the ToggleButton.  In	addition, BBMMeennuu	controls the behavior
  of the ToggleButton if it resides in a PopupMenu system.  The	actual mouse
  button used is determined by its RowColumn parent.

  To accommodate the toggle indicator when created, Label's resource XXmmNNmmaarr--
  ggiinnLLeefftt may be increased.

  Classes

  ToggleButton inherits	behavior and resources from CCoorree, XXmmPPrriimmiittiivvee, and
  XXmmLLaabbeell Classes.

  The class pointer is xxmmTToogggglleeBBuuttttoonnWWiiddggeettCCllaassss.

  The class name is XXmmTToogggglleeBBuuttttoonn.

  New Resources

  The following	table defines a	set of widget resources	used by	the program-
  mer to specify data.	The programmer can also	set the	resource values	for
  the inherited	classes	to set attributes for this widget.  To reference a
  resource by name or by class in a .Xdefaults file, remove the	XXmmNN or XXmmCC
  prefix and use the remaining letters.	 To specify one	of the defined values
  for a	resource in a .Xdefaults file, remove the XXmm prefix and	use the
  remaining letters (in	either lowercase or uppercase, but include any under-
  scores between words).  The codes in the access column indicate if the
  given	resource can be	set at creation	time (C), set by using XXttSSeettVVaalluueess
  (S), retrieved by using XXttGGeettVVaalluueess (G), or is not applicable	(N/A).

			  XXmmTToogggglleeBBuuttttoonn RReessoouurrccee SSeett
       _________________________________________________________________
       NNaammee				  DDeeffaauulltt		  AAcccceessss
	     CCllaassss				TTyyppee
       _________________________________________________________________
       _________________________________________________________________
       XmNarmCallback			  NULL			  C
	     XmCArmCallback			 XtCallbackList
       _________________________________________________________________
       XmNdisarmCallback		  NULL			  C
	     XmCDisarmCallback			 XtCallbackList
       _________________________________________________________________
       XmNfillOnSelect			  dynamic		  CSG
	     XmCFillOnSelect			 Boolean
       _________________________________________________________________
       XmNindicatorOn			  True			  CSG
	     XmCIndicatorOn			 Boolean
       _________________________________________________________________
       XmNindicatorSize			  dynamic		  CSG
	     XmCIndicatorSize			 Dimension
       _________________________________________________________________
       XmNindicatorType			  dynamic		  CSG
	     XmCIndicatorType			 unsigned char
       _________________________________________________________________
       XmNselectColor			  dynamic		  CSG
	     XmCSelectColor			 Pixel
       _________________________________________________________________
       XmNselectInsensitivePixmap	  XmUNSPECIFIED_PIXMAP	  CSG
	     XmCSelectInsensitivePixmap		 Pixmap
       _________________________________________________________________
       XmNselectPixmap			  XmUNSPECIFIED_PIXMAP	  CSG
	     XmCSelectPixmap			 Pixmap
       _________________________________________________________________
       XmNset				  False			  CSG
	     XmCSet				 Boolean
       _________________________________________________________________
       XmNspacing			  4			  CSG
	     XmCSpacing				 Dimension
       _________________________________________________________________
       XmNvalueChangedCallback		  NULL			  C
	     XmCValueChangedCallback		 XtCallbackList
       _________________________________________________________________
       XmNvisibleWhenOff		  dynamic		  CSG
	     XmCVisibleWhenOff			 Boolean
       _________________________________________________________________

  XXmmNNaarrmmCCaallllbbaacckk
	    Specifies the list of callbacks called when	the ToggleButton is
	    armed.  To arm this	widget,	press the active mouse button while
	    the	pointer	is inside the ToggleButton.  For this callback,	the
	    reason is XXmmCCRR__AARRMM.

  XXmmNNddiissaarrmmCCaallllbbaacckk
	    Specifies the list of callbacks called when	ToggleButton is
	    disarmed.  To disarm this widget, press and	release	the active
	    mouse button while the pointer is inside the ToggleButton.	This
	    widget is also disarmed when the user moves	out of the widget and
	    releases the mouse button when the pointer is outside the widget.
	    For	this callback, the reason is XXmmCCRR__DDIISSAARRMM.

  XXmmNNffiillllOOnnSSeelleecctt
	    Fills the indicator	with the color specified in XXmmNNsseelleeccttCCoolloorr
	    and	switches the top and bottom shadow colors when set to True.
	    Otherwise, it switches only	the top	and bottom shadow colors.
	    The	default	is set to the value of XXmmNNiinnddiiccaattoorrOOnn.	When XXmmNNiinnddii--
	    ccaattoorrOOnn is False, and XXmmNNffiillllOOnnSSeelleecctt is set explicitly to True,
	    the	background is filled with the color specified by
	    XXmmNNsseelleeccttCCoolloorr.

  XXmmNNiinnddiiccaattoorrOOnn
	    Specifies that a toggle indicator is drawn to one side of the
	    toggle text	or pixmap when set to True.  When set to False,	no
	    space is allocated for the indicator, and it is not	displayed.
	    If XXmmNNiinnddiiccaattoorrOOnn is True, the indicator shadows are switched
	    when the button is selected	or unselected, but, any	shadows
	    around the entire widget are not switched.	However, if XXmmNNiinnddii--
	    ccaattoorrOOnn is False, any shadows around the entire widget are
	    switched when the toggle is	selected or unselected.

  XXmmNNiinnddiiccaattoorrSSiizzee
	    Sets the size of the indicator.  If	no value is specified, the
	    size of the	indicator is based on the size of the label string or
	    pixmap.  If	the label string or pixmap changes, the	size of	the
	    indicator is recomputed based on the size of the label string or
	    pixmap.  Once a value has been specified for XXmmNNiinnddiiccaattoorrSSiizzee,
	    the	indicator has that size, regardless of the size	of the label
	    string or pixmap, until a new value	is specified.

  XXmmNNiinnddiiccaattoorrTTyyppee
	    Specifies if the indicator is a 11--ooff or NN--ooff indicator.  For the
	    11--ooff indicator, the	value is XXmmOONNEE__OOFF__MMAANNYY.	 For the NN--ooff indica-
	    tor, the value is XXmmNN__OOFF__MMAANNYY.  The	NN--ooff--mmaannyy indicator is
	    square.  The 11--ooff--mmaannyy indicator is	diamond	shaped.	 This
	    resource specifies only the	visuals	and does not enforce the
	    behavior.  When the	ToggleButton is	in a RadioBox, the default is
	    XXmmOONNEE__OOFF__MMAANNYY; otherwise, the default is XXmmNN__OOFF__MMAANNYY.

  XXmmNNsseelleeccttCCoolloorr
	    Allows the application to specify what color fills the center of
	    the	square or diamond-shaped indicator when	it is set.  If this
	    color is the same as either	the top	or the bottom shadow color of
	    the	indicator, a one-pixel-wide margin is left between the sha-
	    dows and the fill; otherwise, it is	filled completely.  This
	    resource's default for a color display is a	color between the
	    background and the bottom shadow color.  For a monochrome
	    display, the default is set	to the foreground color.  To set the
	    background of the button to	XXmmNNsseelleeccttCCoolloorr when XXmmNNiinnddiiccaattoorrOOnn is
	    False, the value of	XXmmNNffiillllOOnnSSeelleecctt	must be	explicitly set to
	    True.

  XXmmNNsseelleeccttIInnsseennssiittiivveePPiixxmmaapp
	    Specifies a	pixmap used as the button face when the	ToggleButton
	    is selected	and the	button is insensitive if the Label resource
	    XXmmNNllaabbeellTTyyppee is set	to XXmmPPIIXXMMAAPP.  If the ToggleButton is
	    unselected and the button is insensitive, the pixmap in XXmmNNllaabbeell--
	    IInnsseennssiittiivveePPiixxmmaapp is used as the button face.  If no value is
	    specified for XXmmNNllaabbeellIInnsseennssiittiivveePPiixxmmaapp, that resource is set to
	    the	value specified	for XXmmNNsseelleeccttIInnsseennssiittiivveePPiixxmmaapp.

  XXmmNNsseelleeccttPPiixxmmaapp
	    Specifies the pixmap to be used as the button face if XXmmNNllaabbeell--
	    TTyyppee is XXmmPPIIXXMMAAPP and the ToggleButton is selected.	When the Tog-
	    gleButton is unselected, the pixmap	specified in Label's XXmmNNllaa--
	    bbeellPPiixxmmaapp is used.	If no value is specified for XXmmNNllaabbeellPPiixxmmaapp,
	    that resource is set to the	value specified	for XXmmNNsseelleeccttPPiixxmmaapp.

  XXmmNNsseett    Represents the state of the	ToggleButton.  A value of false	indi-
	    cates that the ToggleButton	is not set.   A	value of true indi-
	    cates that the ToggleButton	is set.	 Setting this resource sets
	    the	state of the ToggleButton.

  XXmmNNssppaacciinngg
	    Specifies the amount of spacing between the	toggle indicator and
	    the	toggle label (text or pixmap).

  XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
	    Specifies the list of callbacks called when	the ToggleButton
	    value is changed.  To change the value, press and release the
	    active mouse button	while the pointer is inside the	ToggleButton.
	    This action	also causes this widget	to be disarmed.	 For this
	    callback, the reason is XXmmCCRR__VVAALLUUEE__CCHHAANNGGEEDD.

  XXmmNNvviissiibblleeWWhheennOOffff
	    Indicates that the toggle indicator	is visible in the unselected
	    state when the Boolean value is True.  When	the ToggleButton is
	    in a menu, the default value is False.  When the ToggleButton is
	    in a RadioBox, the default value is	True.

  Inherited Resources

  ToggleButton inherits	behavior and resources from the	following superc-
  lasses.  For a complete description of each resource,	refer to the man page
  for that superclass.

			     XXmmLLaabbeell RReessoouurrccee SSeett
      ___________________________________________________________________
      NNaammee				DDeeffaauulltt			   AAcccceessss
	    CCllaassss			      TTyyppee
      ___________________________________________________________________
      ___________________________________________________________________
      XmNaccelerator			NULL			   CSG
	    XmCAccelerator		       String
      ___________________________________________________________________
      XmNacceleratorText		NULL			   CSG
	    XmCAcceleratorText		       XmString
      ___________________________________________________________________
      XmNalignment			dynamic			   CSG
	    XmCAlignment		       unsigned	char
      ___________________________________________________________________
      XmNfontList			dynamic			   CSG
	    XmCFontList			       XmFontList
      ___________________________________________________________________
      XmNlabelInsensitivePixmap		XmUNSPECIFIED_PIXMAP	   CSG
	    XmCLabelInsensitivePixmap	       Pixmap
      ___________________________________________________________________
      XmNlabelPixmap			XmUNSPECIFIED_PIXMAP	   CSG
	    XmCLabelPixmap		       Pixmap
      ___________________________________________________________________
      XmNlabelString			dynamic			   CSG
	    XmCXmString			       XmString
      ___________________________________________________________________
      XmNlabelType			XmSTRING		   CSG
	    XmCLabelType		       unsigned	char
      ___________________________________________________________________
      XmNmarginBottom			dynamic			   CSG
	    XmCMarginBottom		       Dimension
      ___________________________________________________________________
      XmNmarginHeight			2			   CSG
	    XmCMarginHeight		       Dimension
      ___________________________________________________________________
      XmNmarginLeft			dynamic			   CSG
	    XmCMarginLeft		       Dimension
      ___________________________________________________________________
      XmNmarginRight			0			   CSG
	    XmCMarginRight		       Dimension
      ___________________________________________________________________
      XmNmarginTop			dynamic			   CSG
	    XmCMarginTop		       Dimension
      ___________________________________________________________________
      XmNmarginWidth			2			   CSG
	    XmCMarginWidth		       Dimension
      ___________________________________________________________________
      XmNmnemonic			NULL			   CSG
	    XmCMnemonic			       KeySym
      ___________________________________________________________________
      XmNmnemonicCharSet		XmFONTLIST_DEFAULT_TAG	   CSG
	    XmCMnemonicCharSet		       String
      ___________________________________________________________________
      XmNrecomputeSize			True			   CSG
	    XmCRecomputeSize		       Boolean
      ___________________________________________________________________
      XmNstringDirection		dynamic			   CSG
	    XmCStringDirection		       XmStringDirection
      ___________________________________________________________________

			   XXmmPPrriimmiittiivvee RReessoouurrccee	SSeett
	______________________________________________________________
	NNaammee			      DDeeffaauulltt			AAcccceessss
	      CCllaassss			    TTyyppee
	______________________________________________________________
	______________________________________________________________
	XmNbottomShadowColor	      dynamic			CSG
	      XmCBottomShadowColor	     Pixel
	______________________________________________________________
	XmNbottomShadowPixmap	      XmUNSPECIFIED_PIXMAP	CSG
	      XmCBottomShadowPixmap	     Pixmap
	______________________________________________________________
	XmNforeground		      dynamic			CSG
	      XmCForeground		     Pixel
	______________________________________________________________
	XmNhelpCallback		      NULL			C
	      XmCCallback		     XtCallbackList
	______________________________________________________________
	XmNhighlightColor	      dynamic			CSG
	      XmCHighlightColor		     Pixel
	______________________________________________________________
	XmNhighlightOnEnter	      False			CSG
	      XmCHighlightOnEnter	     Boolean
	______________________________________________________________
	XmNhighlightPixmap	      dynamic			CSG
	      XmCHighlightPixmap	     Pixmap
	______________________________________________________________
	XmNhighlightThickness	      2				CSG
	      XmCHighlightThickness	     Dimension
	______________________________________________________________
	XmNnavigationType	      XmNONE			CSG
	      XmCNavigationType		     XmNavigationType
	______________________________________________________________
	XmNshadowThickness	      dynamic			CSG
	      XmCShadowThickness	     Dimension
	______________________________________________________________
	XmNtopShadowColor	      dynamic			CSG
	      XmCTopShadowColor		     Pixel
	______________________________________________________________
	XmNtopShadowPixmap	      dynamic			CSG
	      XmCTopShadowPixmap	     Pixmap
	______________________________________________________________
	XmNtraversalOn		      True			CSG
	      XmCTraversalOn		     Boolean
	______________________________________________________________
	XmNunitType		      dynamic			CSG
	      XmCUnitType		     unsigned char
	______________________________________________________________
	XmNuserData		      NULL			CSG
	      XmCUserData		     XtPointer
	______________________________________________________________

			      CCoorree RReessoouurrccee SSeett
     ____________________________________________________________________
     NNaammee				   DDeeffaauulltt		   AAcccceessss
	   CCllaassss				 TTyyppee
     ____________________________________________________________________
     ____________________________________________________________________
     XmNaccelerators			   dynamic		   CSG
	   XmCAccelerators			  XtAccelerators
     ____________________________________________________________________
     XmNancestorSensitive		   dynamic		   G
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNbackground			   dynamic		   CSG
	   XmCBackground			  Pixel
     ____________________________________________________________________
     XmNbackgroundPixmap		   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderColor			   XtDefaultForeground	   CSG
	   XmCBorderColor			  Pixel
     ____________________________________________________________________
     XmNborderPixmap			   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderWidth			   0			   CSG
	   XmCBorderWidth			  Dimension
     ____________________________________________________________________
     XmNcolormap			   dynamic		   CG
	   XmCColormap				  Colormap
     ____________________________________________________________________
     XmNdepth				   dynamic		   CG
	   XmCDepth				  int
     ____________________________________________________________________
     XmNdestroyCallback			   NULL			   C
	   XmCCallback				  XtCallbackList
     ____________________________________________________________________
     XmNheight				   dynamic		   CSG
	   XmCHeight				  Dimension
     ____________________________________________________________________
     XmNinitialResourcesPersistent	   True			   C
	   XmCInitialResourcesPersistent	  Boolean
     ____________________________________________________________________
     XmNmappedWhenManaged		   True			   CSG
	   XmCMappedWhenManaged			  Boolean
     ____________________________________________________________________
     XmNscreen				   dynamic		   CG
	   XmCScreen				  Screen *
     ____________________________________________________________________
     XmNsensitive			   True			   CSG
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNtranslations			   dynamic		   CSG
	   XmCTranslations			  XtTranslations
     ____________________________________________________________________
     XmNwidth				   dynamic		   CSG
	   XmCWidth				  Dimension
     ____________________________________________________________________
     XmNx				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________
     XmNy				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________



  Callback Information

  A pointer to the following structure is passed to each callback:


  ttyyppeeddeeff ssttrruucctt
  {{
    iinntt		 _r_e_a_s_o_n;;
    XXEEvveenntt	 * _e_v_e_n_t;;
    iinntt		 _s_e_t;;
  }} XXmmTToogggglleeBBuuttttoonnCCaallllbbaacckkSSttrruucctt;;

  _r_e_a_s_o_n Indicates why the callback was	invoked

  _e_v_e_n_t	 Points	to the XXEEvveenntt that triggered the callback

  _s_e_t	 Reflects the ToggleButton's current state when	the callback
	 occurred, either True (selected) or False (unselected)

  Translations

  XmToggleButton includes translations from Primitive.	Additional XmTog-
  gleButton translations for buttons not in a menu system are listed below.
  These	translations may not directly correspond to a translation table.

  Note that altering translations in ##oovveerrrriiddee or ##aauuggmmeenntt mode	is undefined.


       BBDDrraaggPPrreessss::    PPrroocceessssDDrraagg(())
       BBSSeelleecctt PPrreessss:: AArrmm(())
       BBSSeelleecctt RReelleeaassee::SSeelleecctt(())
		      DDiissaarrmm(())
       KKHHeellpp::	      HHeellpp(())
       KKSSeelleecctt::	      AArrmmAAnnddAAccttiivvaattee(())

  XmToggleButton inherits menu traversal translations from XmLabel.  Addi-
  tional XmToggleButton	translations for ToggleButtons in a menu system	are
  listed below.	 In a Popup menu system, BBMMeennuu also performs the BBSSeelleecctt
  actions.  These translations may not directly	correspond to a	translation
  table.


       BBSSeelleecctt PPrreessss:: BBttnnDDoowwnn(())
       BBSSeelleecctt RReelleeaassee::BBttnnUUpp(())
       KKHHeellpp::	      HHeellpp(())
       KKAAccttiivvaattee::     AArrmmAAnnddAAccttiivvaattee(())
       KKSSeelleecctt::	      AArrmmAAnnddAAccttiivvaattee(())
       MMAAnnyy KKCCaanncceell::  MMeennuuSShheellllPPooppddoowwnnOOnnee(())

  Action Routines

  The XmToggleButton action routines are described below:

  AArrmm(()):    If the button was previously unset,	this action does the follow-
	    ing: If XXmmNNiinnddiiccaattoorrOOnn is True, it draws the indicator shadow so
	    that the indicator looks pressed; if XXmmNNffiillllOOnnSSeelleecctt is True, it
	    fills the indicator	with the color specified by XXmmNNsseelleeccttCCoolloorr.
	    If XXmmNNiinnddiiccaattoorrOOnn is False,	it draws the button shadow so that
	    the	button looks pressed.  If XXmmNNllaabbeellTTyyppee is XXmmPPIIXXMMAAPP, the
	    XXmmNNsseelleeccttPPiixxmmaapp is used as the button face.	 Calls the






	    XXmmNNaarrmmCCaallllbbaacckk callbacks.

	    If the button was previously set, this action does the following:
	    If both XXmmNNiinnddiiccaattoorrOOnn and XXmmNNvviissiibblleeWWhheennOOffff are True, it draws
	    the	indicator shadow so that the indicator looks raised; if
	    XXmmNNffiillllOOnnSSeelleecctt is True, it	fills the indicator with the back-
	    ground color.  If XXmmNNiinnddiiccaattoorrOOnn is	False, it draws	the button
	    shadow so that the button looks raised.  If	XXmmNNllaabbeellTTyyppee is
	    XXmmPPIIXXMMAAPP, the XXmmNNllaabbeellPPiixxmmaapp is used as the	button face.  Calls
	    the	XXmmNNaarrmmCCaallllbbaacckk callbacks.

  AArrmmAAnnddAAccttiivvaattee(()):
	    If the ToggleButton	was previously set, unsets it; if the Tog-
	    gleButton was previously unset, sets it.

	    In a menu, does the	following: Unposts all menus in	the menu
	    hierarchy.	Unless the button is already armed, calls the XXmmNNaarrmm--
	    CCaallllbbaacckk callbacks.	 Calls the XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk and
	    XXmmNNddiissaarrmmCCaallllbbaacckk callbacks.

	    Outside a menu, if the button was previously unset,	this action
	    does the following:	If XXmmNNiinnddiiccaattoorrOOnn is True, it draws the	indi-
	    cator shadow so that the indicator looks pressed; if XXmmNNffiillllOOnn--
	    SSeelleecctt is True, it fills the indicator with	the color specified
	    by XXmmNNsseelleeccttCCoolloorr.	If XXmmNNiinnddiiccaattoorrOOnn is False, it draws the but-
	    ton	shadow so that the button looks	pressed.  If XXmmNNllaabbeellTTyyppee is
	    XXmmPPIIXXMMAAPP, the XXmmNNsseelleeccttPPiixxmmaapp is used as the button	face.  Calls
	    the	XXmmNNaarrmmCCaallllbbaacckk,	XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk, and XXmmNNddiissaarrmmCCaallll--
	    bbaacckk callbacks.

	    Outside a menu, if the button was previously set, this action
	    does the following:	If both	XXmmNNiinnddiiccaattoorrOOnn and XXmmNNvviissiibblleeWWhheennOOffff
	    are	True, it draws the indicator shadow so that the	indicator
	    looks raised; if XXmmNNffiillllOOnnSSeelleecctt is	True, it fills the indicator
	    with the background	color.	If XXmmNNiinnddiiccaattoorrOOnn is False, it draws
	    the	button shadow so that the button looks raised.	If XXmmNNllaabbeell--
	    TTyyppee is XXmmPPIIXXMMAAPP, the XXmmNNllaabbeellPPiixxmmaapp is used as the	button face.
	    Calls the XXmmNNaarrmmCCaallllbbaacckk, XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk, and XXmmNNddiissaarrmm--
	    CCaallllbbaacckk callbacks.

  BBttnnDDoowwnn(()):
	    This action	unposts	any menus posted by the	ToggleButton's parent
	    menu, disables keyboard traversal for the menu, and	enables	mouse
	    traversal for the menu.  It	draws the shadow in the	armed state
	    and, unless	the button is already armed, calls the XXmmNNaarrmmCCaallllbbaacckk
	    callbacks.

  BBttnnUUpp(()):  This action	unposts	all menus in the menu hierarchy.  If the Tog-
	    gleButton was previously set, unsets it; if	the ToggleButton was
	    previously unset, sets it.	It calls the XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
	    callbacks and then the XXmmNNddiissaarrmmCCaallllbbaacckk callbacks.

  DDiissaarrmm(()): Calls the callbacks	for XXmmNNddiissaarrmmCCaallllbbaacckk.

  HHeellpp(()):   In a Pulldown or Popup MenuPane, unposts all menus in the menu
	    hierarchy and restores keyboard focus to the widget	that had the
	    focus before the menu system was entered.  Calls the callbacks
	    for	XXmmNNhheellppCCaallllbbaacckk	if any exist.  If there	are no help callbacks
	    for	this widget, this action calls the help	callbacks for the
	    nearest ancestor that has them.

  MMeennuuSShheellllPPooppddoowwnnOOnnee(()):
	    In a toplevel Pulldown MenuPane from a MenuBar, unposts the	menu,
	    disarms the	MenuBar	CascadeButton and the MenuBar, and restores
	    keyboard focus to the widget that had the focus before the Menu-
	    Bar	was entered.  In other Pulldown	MenuPanes, unposts the menu.

	    In a Popup MenuPane, unposts the menu and restores keyboard	focus
	    to the widget from which the menu was posted.

  PPrroocceessssDDrraagg(()):
	    Drags the contents of a ToggleButton label,	identified by press-
	    ing	BBDDrraagg.	This action creates a DragContext object whose XXmmNNeexx--
	    ppoorrttTTaarrggeettss	resource is set	to "COMPOUND_TEXT" for a label type
	    of XXmmSSTTRRIINNGG; otherwise, "PIXMAP" if	the label type is XXmmPPIIXXMMAAPP.
	    This action	is undefined for ToggleButtons used in a menu system.

  SSeelleecctt(()): If the pointer is within the button, takes the following actions:
	    If the button was previously unset,	sets it; if the	button was
	    previously set, unsets it.	Calls the XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
	    callbacks.

  Additional Behavior

  This widget has the additional behavior described below:

  <<EEnntteerrWWiinnddooww>>:
	    In a menu, if keyboard traversal is	enabled, this action does
	    nothing.  Otherwise, it draws the shadow in	the armed state	and
	    calls the XXmmNNaarrmmCCaallllbbaacckk callbacks.

	    If the ToggleButton	is not in a menu and the cursor	leaves and
	    then reenters the ToggleButton's window while the button is
	    pressed, this action restores the button's armed appearance.

  <<LLeeaavveeWWiinnddooww>>:
	    In a menu, if keyboard traversal is	enabled, this action does
	    nothing.  Otherwise, it draws the shadow in	the unarmed state and
	    calls the XXmmNNddiissaarrmmCCaallllbbaacckk	callbacks.

	    If the ToggleButton	is not in a menu and the cursor	leaves the
	    ToggleButton's window while	the button is pressed, this action
	    restores the button's unarmed appearance.

  Virtual Bindings

  The bindings for virtual keys	are vendor specific.  For information about
  bindings for virtual buttons and keys, see VViirrttuuaallBBiinnddiinnggss((33XX)).

RELATED	INFORMATION
  CCoorree((33XX)), XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeTToogggglleeBBuuttttoonn((33XX)), XXmmLLaabbeell((33XX)),
  XXmmPPrriimmiittiivvee((33XX)), XXmmRRoowwCCoolluummnn((33XX)), XXmmTToogggglleeBBuuttttoonnGGeettSSttaattee((33XX)),	and
  XXmmTToogggglleeBBuuttttoonnSSeettSSttaattee((33XX)).



















