


XmToggleButtonGadget(3X)			     XmToggleButtonGadget(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmTToogggglleeBBuuttttoonnGGaaddggeett - The ToggleButtonGadget	widget class

SYNOPSIS


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

DESCRIPTION
  ToggleButtonGadget sets nontransitory	state data within an application.
  Usually this gadget consists of an indicator (square or diamond-shaped)
  with either text or a	pixmap on one side of it.  However, it can also	con-
  sist 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-shaped indicator shows a 11--ooff--mmaannyy selection
  state.

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

  The default behavior associated with a ToggleButtonGadget in a menu depends
  on the type of menu system in	which it resides.  By default, BBSSeelleecctt con-
  trols	the behavior of	the ToggleButtonGadget.	 In addition, BBMMeennuu controls
  the behavior of the ToggleButtonGadget 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

  ToggleButtonGadget inherits behavior and resources from OObbjjeecctt, RReeccttOObbjj,
  XXmmGGaaddggeett and XXmmLLaabbeellGGaaddggeett classes.

  The class pointer is xxmmTToogggglleeBBuuttttoonnGGaad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nGGaaddggeett.

  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
  underscores 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nGGaaddggeett 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 a	list of	callbacks that is called when the ToggleBut-
	    tonGadget is armed.	 To arm	this gadget, press the active mouse
	    button while the pointer is	inside the ToggleButtonGadget.	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 a	list of	callbacks called when ToggleButtonGadget is
	    disarmed.  To disarm this gadget, press and	release	the active
	    mouse button while the pointer is inside the ToggleButtonGadget.
	    The	gadget is also disarmed	when the user moves out	of the gadget
	    and	releases the mouse button when the pointer is outside the
	    gadget.  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 gadget are not switched.	 However, if XXmmNNiinnddiiccaattoorrOOnn
	    is False, any shadows around the entire gadget 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 an 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
	    indicator, 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	ToggleButtonGadget 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	ToggleBut-
	    tonGadget is selected and the button is insensitive	if the Label-
	    Gadget resource XXmmNNllaabbeellTTyyppee is XXmmPPIIXXMMAAPP.  If the ToggleBut-
	    tonGadget is unselected and	the button is insensitive, the pixmap
	    in 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 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 ToggleButtonGadget	is selected.  When
	    the	ToggleButtonGadget is unselected, the pixmap specified in
	    LabelGadget's XXmmNNllaab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
	    indicates that the ToggleButton is not set.	  A value of true
	    indicates 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 a	list of	callbacks called when the ToggleButtonGadget
	    value is changed.  To change the value, press and release the
	    active mouse button	while the pointer is inside the	ToggleBut-
	    tonGadget.	This action also causes	the gadget 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 ToggleBut-
	    tonGadget is in a menu, the	default	value is False.	 When the
	    ToggleButtonGadget is in a RadioBox, the default value is True.

  Inherited Resources

  ToggleButtonGadget inherits behavior and resources from the following
  superclasses.	 For a complete	description of each resource, refer to the
  man page for that superclass.

			  XXmmLLaabbeellGGaaddggeett	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		dynamic			   CSG
	    XmCMnemonicCharSet		       String
      ___________________________________________________________________
      XmNrecomputeSize			True			   CSG
	    XmCRecomputeSize		       Boolean
      ___________________________________________________________________
      XmNstringDirection		dynamic			   CSG
	    XmCStringDirection		       XmStringDirection
      ___________________________________________________________________

			    XXmmGGaaddggeett 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			G
	      XmCBottomShadowColor	     Pixel
	______________________________________________________________
	XmNhelpCallback		      NULL			C
	      XmCCallback		     XtCallbackList
	______________________________________________________________
	XmNhighlightColor	      dynamic			G
	      XmCHighlightColor		     Pixel
	______________________________________________________________
	XmNhighlightOnEnter	      False			CSG
	      XmCHighlightOnEnter	     Boolean
	______________________________________________________________
	XmNhighlightThickness	      2				CSG
	      XmCHighlightThickness	     Dimension
	______________________________________________________________
	XmNnavigationType	      XmNONE			CSG
	      XmCNavigationType		     XmNavigationType
	______________________________________________________________
	XmNshadowThickness	      dynamic			CSG
	      XmCShadowThickness	     Dimension
	______________________________________________________________
	XmNtopShadowColor	      dynamic			G
	      XmCTopShadowColor		     Pixel
	______________________________________________________________
	XmNtraversalOn		      True			CSG
	      XmCTraversalOn		     Boolean
	______________________________________________________________
	XmNunitType		      dynamic			CSG
	      XmCUnitType		     unsigned char
	______________________________________________________________
	XmNuserData		      NULL			CSG
	      XmCUserData		     XtPointer
	______________________________________________________________

			     RReeccttOObbjj 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
	       ________________________________________________
	       ________________________________________________
	       XmNancestorSensitive   dynamic		 G
		     XmCSensitive	     Boolean
	       ________________________________________________
	       XmNborderWidth	      0			 CSG
		     XmCBorderWidth	     Dimension
	       ________________________________________________
	       XmNheight	      dynamic		 CSG
		     XmCHeight		     Dimension
	       ________________________________________________
	       XmNsensitive	      True		 CSG
		     XmCSensitive	     Boolean
	       ________________________________________________
	       XmNwidth		      dynamic		 CSG
		     XmCWidth		     Dimension
	       ________________________________________________
	       XmNx		      0			 CSG
		     XmCPosition	     Position
	       ________________________________________________
	       XmNy		      0			 CSG
		     XmCPosition	     Position
	       ________________________________________________

			      OObbjjeecctt 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
	      ___________________________________________________
	      ___________________________________________________
	      XmNdestroyCallback   NULL			   C
		    XmCCallback		  XtCallbackList
	      ___________________________________________________

  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 ToggleButtonGadget's current state when the callback
	 occurred, either True (selected) or False (unselected)

  Behavior

  XmToggleButtonGadget includes	behavior from XmGadget.	 XmToggleButtonGadget
  includes menu	traversal behavior from	XmLabelGadget.	Additional XmTog-
  gleButtonGadget behavior is described	below:

  BBDDrraagg	PPrreessss:
	    Drags the contents of a ToggleButtonGadget label, identified by
	    pressing BBDDrraagg.  This action creates a DragContext object whose
	    XXmmNNeexxp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X--
	    MMAAPP.  This action is undefined for ToggleButtonGadgets used	in a
	    menu system.

  BBSSeelleecctt PPrreessss:
	    In a menu, this action unposts any menus posted by the
	    ToggleButtonGadget'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.

	    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 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 callbacks.

  BBSSeelleecctt RReelleeaassee:
	    In a menu, this action does	the following: It unposts all menus
	    in the menu	hierarchy.  If the ToggleButtonGadget was previously
	    set, unsets	it; if the ToggleButtonGadget 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.

	    If the button is outside a menu and	the pointer is within the
	    button, this action	does the following: If the button was previ-
	    ously 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.

	    If the button is outside a menu, calls the XXmmNNddiissaarrmmCCaallllbbaacckk
	    callbacks.

  KKHHeellpp:    In a Pulldown or Popup MenuPane, unposts all menus in the menu
	    hierarchy and, when	the shell's keyboard focus policy is XXmmEEXX--
	    PPLLIICCTT, 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.

  AAccttiivvaattee: 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;	and 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 parent	is a
	    manager, passes the	event to the parent.

  KKSSeelleecctt:  If the ToggleButtonGadget was previously set, unsets it; if	the
	    ToggleButtonGadget 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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 but-
	    ton	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,
	    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 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.

  MMAAnnyy KKCCaanncceell:
	    In a toplevel Pulldown MenuPane from a MenuBar, unposts the	menu,
	    disarms the	MenuBar	CascadeButton and the MenuBar, and, when the
	    shell's keyboard focus policy is XXmmEEXXPPLLIICCTT,	restores keyboard
	    focus to the widget	that had the focus before the MenuBar was
	    entered.  In other Pulldown	MenuPanes, unposts the menu.  Outside
	    a menu, if the parent is a manager,	this action passes the event
	    to the parent.

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

  <<EEnntteerr>>:  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 ToggleButtonGadget is not in	a menu and the cursor leaves
	    and	then reenters the ToggleButtonGadget while the button is
	    pressed, this action restores the button's armed appearance.

  <<LLeeaavvee>>:  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 ToggleButtonGadget is not in	a menu and the cursor leaves
	    the	ToggleButtonGadget 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
  OObbjjeecctt((33XX)), RReeccttOObbjj((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nGGaaddggeett((33XX)), XXmmGGaaddggeett((33XX)),	XXmmLLaabbeellGGaaddggeett((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GaaddggeettG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nGGaaddggeettSSeettSSttaattee((33XX)).

















