


XmPushButton(3X)					     XmPushButton(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmPPuusshhBBuuttttoonn - The PushButton	widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//PPuusshhBB..hh>>

DESCRIPTION
  PushButton issues commands within an application.  It	consists of a text
  label	or pixmap surrounded by	a border shadow.  When a PushButton is
  selected, the	shadow changes to give the appearance that it has been
  pressed in.  When a PushButton is unselected,	the shadow changes to give
  the appearance that it is out.

  The default behavior associated with a PushButton 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 PushButton.  In addition, BBMMeennuu controls the behavior	of
  the PushButton if it resides in a PopupMenu system.  The actual mouse	but-
  ton used is determined by its	RowColumn parent.

  Thickness for	a second shadow, used when the PushButton is the default but-
  ton,	may be specified by using the XXmmNNsshhoowwAAssDDeeffaauulltt resource.  If it	has a
  non-zero value, the Label's resources	XXmmNNmmaarrggiinnLLeefftt, XXmmNNmmaarrggiinnRRiigghhtt,
  XXmmNNmmaarrggiinnTToopp,	and XXmmNNmmaarrggiinnBBoottttoomm may	be modified to accommodate the second
  shadow.

  If an	initial	value is specified for XXmmNNaarrmmPPiixxmmaapp but	not for	XXmmNNllaabbeellPPiixx--
  mmaapp, the XXmmNNaarrmmPPiixxmmaapp	value is used for XXmmNNllaabbeellPPiixxmmaapp.

  Classes

  PushButton 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mPPuusshhBBuuttttoonnWWiiddggeettCCllaassss.

  The class name is XXmmPPuusshhB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mPPuusshhB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
    ______________________________________________________________________
    ______________________________________________________________________
    XmNactivateCallback			    NULL		    C
	  XmCCallback				   XtCallbackList
    ______________________________________________________________________
    XmNarmCallback			    NULL		    C
	  XmCCallback				   XtCallbackList
    ______________________________________________________________________
    XmNarmColor				    dynamic		    CSG
	  XmCArmColor				   Pixel
    ______________________________________________________________________
    XmNarmPixmap			    XmUNSPECIFIED_PIXMAP    CSG
	  XmCArmPixmap				   Pixmap
    ______________________________________________________________________
    XmNdefaultButtonShadowThickness	    dynamic		    CSG
	  XmCDefaultButtonShadowThickness	   Dimension
    ______________________________________________________________________
    XmNdisarmCallback			    NULL		    C
	  XmCCallback				   XtCallbackList
    ______________________________________________________________________
    XmNfillOnArm			    True		    CSG
	  XmCFillOnArm				   Boolean
    ______________________________________________________________________
    XmNmultiClick			    dynamic		    CSG
	  XmCMultiClick				   unsigned char
    ______________________________________________________________________
    XmNshowAsDefault			    0			    CSG
	  XmCShowAsDefault			   Dimension
    ______________________________________________________________________

  XXmmNNaaccttiivvaatteeCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	PushButton is
	    activated.	PushButton is activated	when the user presses and
	    releases the active	mouse button while the pointer is inside that
	    widget.  Activating	the PushButton also disarms it.	 For this
	    callback the reason	is XXmmCCRR__AACCTTIIVVAATTEE.

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

  XXmmNNaarrmmCCoolloorr
	    Specifies the color	with which to fill the armed button.  XXmmNNffiill--
	    llOOnnAArrmm must	be set to True for this	resource to have an effect.
	    The	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, and	any text in the	label
	    appears in the background color when the button is armed.

  XXmmNNaarrmmP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 PushButton is armed.  This resource is	dis-
	    abled when the PushButton is in a menu.

  XXmmNNddeeffaauullttBBuuttttoonnSShhaaddoowwTThhiicckknneessss
	    This resource specifies the	width of the default button indicator
	    shadow.  If	this resource is zero, the width of the	shadow comes
	    from the value of the XXmmNNsshhoowwAAssDDeeffaauulltt resource.  If this
	    resource is	greater	than zero, the XXmmNNsshhoowwAAssDDeeffaauulltt	resource is
	    only used to specify whether this button is	the default.  The
	    default value is the initial value of XXmmNNsshhoowwAAssDDeeffaauulltt.

  XXmmNNddiissaarrmmCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	PushButton is
	    disarmed.  PushButton is disarmed when the user presses and
	    releases the active	mouse button while the pointer is inside that
	    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nAArrmm
	    Forces the PushButton to fill the background of the	button with
	    the	color specified	by XXmmNNaarrmmCCoolloorr when the	button is armed	and
	    when this resource is set to True.	If False, only the top and
	    bottom shadow colors are switched.	When the PushButton is in a
	    menu, this resource	is ignored and assumed to be False.

  XXmmNNmmuullttiiCClliicckk
	    If a button	click is followed by another button click within the
	    time span specified	by the display's multi-click time, and this
	    resource is	set to XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, do	not process the
	    second click.  If this resource is set to XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, pro-
	    cess the event and increment _c_l_i_c_k__c_o_u_n_t in	the callback struc-
	    ture.  When	the button is in a menu, the default is
	    XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD; otherwise, for a button not in a menu,
	    XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP is the default value.

  XXmmNNsshhoowwAAssDDeeffaauulltt
	    If XXmmNNddeeffaauullttBBuuttttoonnSShhaaddoowwTThhiicckknneessss is greater than zero, a value
	    greater than zero in this resource specifies to mark this button
	    as the default button.  If XXmmNNddeeffaauullttBBuuttttoonnSShhaaddoowwTThhiicckknneessss is
	    zero, a value greater than zero in this resource specifies to
	    mark this button as	the default button with	the shadow thickness
	    specified by this resource.	 The space between the shadow and the
	    default shadow is equal to the sum of both shadows.	 The default
	    value is zero.  When this value is not zero, the Label resources
	    XXmmNNmmaarrggiinnLLeefftt, XXmmNNmmaarrggiinnRRiigghhtt, XXmmNNmmaarrggiinnTToopp, and XXmmNNmmaarrggiinnBBoottttoomm
	    may	be modified to accommodate the second shadow.  This resource
	    is disabled	when the PushButton is in a menu.

  Inherited Resources

  PushButton 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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			dynamic			   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			dynamic			   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	      2				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	     _c_l_i_c_k__c_o_u_n_t;;
  }} XXmmPPuusshhB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.

  _c_l_i_c_k__c_o_u_n_t
	 This value is valid only when the reason is XXmmCCRR__AACCTTIIVVAATTEE.  It	con-
	 tains the number of clicks in the last	multiclick sequence if the
	 XXmmNNmmuullttiiCClliicckk resource	is set to XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, otherwise it
	 contains 11.  The activate callback is invoked for each	click if
	 XXmmNNmmuullttiiCClliicckk is set to XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP.

  Translations

  XmPushButton includes	translations from Primitive.

  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.

  Additional XmPushButton translations for XmPushButtons not in	a menu system
  are listed below.  These translations	may not	directly correspond to a
  translation table.

       BBDDrraagg P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 CClliicckk:: AAccttiivvaattee(())
		      DDiissaarrmm(())
       BBSSeelleecctt RReelleeaassee::AAccttiivvaattee(())
		      DDiissaarrmm(())
       BBSSeelleecctt PPrreessss 22++::MMuullttiiAArrmm(())
       BBSSeelleecctt RReelleeaassee 22++::MMuullttiiAAccttiivvaattee(())
		      DDiissaarrmm(())
       KKSSeelleecctt::	      AArrmmAAnnddAAccttiivvaattee(())
       KKHHeellpp::	      HHeellpp(())

  XmPushButton inherits	menu traversal translations from XmLabel.  Additional
  XmPushButton translations for	PushButtons 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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 XmPushButton action routines are described below:

  AAccttiivvaattee(()):
	    This action	draws the shadow in the	unarmed	state.	If the button
	    is not in a	menu and if XXmmNNffiillllOOnnAArrmm is set	to True, the back-
	    ground color reverts to the	unarmed	color.	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 for the button	face.  If the
	    pointer is still within the	button,	this action calls the call-
	    backs for XXmmNNaaccttiivvaatteeCCaallllbbaacckk.

  AArrmm(()):    This action	arms the PushButton.  It draws the shadow in the
	    armed state.  If the button	is not in a menu and if	XXmmNNffiillllOOnnAArrmm
	    is set to True, it fills the button	with the color specified by
	    XXmmNNaarrmmCCoolloorr.  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NaarrmmPPiixxmmaapp	is
	    used for the button	face.  It 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(()):
	    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NaaccttiivvaatteeC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.

	    Outside a menu, does the following:	Draws the shadow in the	armed
	    state and, if XXmmNNffiillllOOnnAArrmm is set to True, fills the button	with
	    the	color specified	by XXmmNNaarrmmCCoolloorr.	 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NaarrmmPPiixxmmaapp is	used for the button face.  Calls the XXmmNNaarrmm--
	    CCaallllbbaacckk callbacks.

	    Outside a menu, this action	also arranges for the following	to
	    happen, either immediately or at a later time: The shadow is
	    drawn in the unarmed state and, if XXmmNNffiillllOOnnAArrmm is set to True,
	    the	background color reverts to the	unarmed	color.	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 for the button	face.
	    The	XXmmNNaaccttiivvaatteeC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 are
	    called.

  BBttnnDDoowwnn(()):
	    This action	unposts	any menus posted by the	PushButton'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	and activates
	    the	PushButton.  It	calls the XXmmNNaaccttiivvaatteeC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, 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 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, 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.

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

  MMuullttiiAAccttiivvaattee(()):
	    If XXmmNNmmuullttiiCClliicckk is	XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, this action does noth-
	    ing.

	    If XXmmNNmmuullttiiCClliicckk is	XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, this	action does the	fol-
	    lowing: Increments _c_l_i_c_k__c_o_u_n_t in the callback structure.  Draws
	    the	shadow in the unarmed state.  If the button is not in a	menu
	    and	if XXmmNNffiillllOOnnAArrmm	is set to True,	the background color reverts
	    to the unarmed color.  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l--
	    PPiixxmmaapp is used for the button face.	 If the	pointer	is within the
	    PushButton,	calls the callbacks for	XXmmNNaaccttiivvaatteeCCaallllbbaacckk.  Calls
	    the	callbacks for XXmmNNddiissaarrmmCCaallllbbaacckk.

  MMuullttiiAArrmm(()):
	    If XXmmNNmmuullttiiCClliicckk is	XXmmMMUULLTTIICCLLIICCKK__DDIISSCCAARRDD, this action does noth-
	    ing.

	    If XXmmNNmmuullttiiCClliicckk is	XXmmMMUULLTTIICCLLIICCKK__KKEEEEPP, this	action does the	fol-
	    lowing: Draws the shadow in	the armed state.  If the button	is
	    not	in a menu and if XXmmNNffiillllOOnnAArrmm is set to	True, fills the	but-
	    ton	with the color specified by XXmmNNaarrmmCCoolloorr.  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NaarrmmPPiixxmmaapp is used for the button face.  Calls
	    the	XXmmNNaarrmmCCaallllbbaacckk callbacks.

  PPrroocceessssDDrraagg(()):
	    Drags the contents of a PushButton 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t--
	    T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 PushButtons used in a menu system.

  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 PushButton is not in	a menu and the cursor leaves and then
	    reenters the PushButton's window while the button is pressed,
	    this action	draws the shadow in the	armed state.  If XXmmNNffiillllOOnnAArrmm
	    is set to True, it also fills the button with the color specified
	    by XXmmNNaarrmmCCoolloorr.  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NaarrmmPPiixxmmaapp is
	    used for the button	face.

  <<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 PushButton is not in	a menu and the cursor leaves the
	    PushButton's window	while the button is pressed, this action
	    draws the shadow in	the unarmed state.  If XXmmNNffiillllOOnnAArrmm is set to
	    True, the background color reverts to the unarmed color.  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 for the but-
	    ton	face.

  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ePPuusshhB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)), and
  XXmmRRoowwCCoolluummnn((33XX)).























































