Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmPushButtonGadget(3)	   Library Functions Manual	 XmPushButtonGadget(3)

NAME
       XmPushButtonGadget -- The PushButtonGadget widget class

SYNOPSIS
       #include	<Xm/PushBG.h>

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

       The default behavior associated with a PushButtonGadget in a  menu  de-
       pends  on  the  type  of	 menu system in	which it resides.  By default,
       <Btn1> controls the behavior of	the  PushButtonGadget.	 In  addition,
       <Btn3> controls the behavior of the PushButtonGadget if it resides in a
       PopupMenu system.  The actual mouse button used is  determined  by  its
       RowColumn parent.

       Thickness  for  a  second shadow	may be specified with the XmNshowAsDe-
       fault resource. If it has a nonzero value, the  Label's	XmNmarginLeft,
       XmNmarginRight, XmNmarginTop, and XmNmarginBottom resources may be mod-
       ified to	accommodate the	second shadow.

       If an initial value is specified	for XmNarmPixmap but  not  for	XmNla-
       belPixmap, the XmNarmPixmap value is used for XmNlabelPixmap.

       PushButtonGadget	 uses  the  XmQTmenuSystem  and	XmQTspecifyRenderTable
       traits, and holds the XmQactivatable, XmQTmenuSavvy,  and  XmQTtakesDe-
       fault traits.

   Classes
       PushButtonGadget	 inherits behavior, resources, and traits from Object,
       RectObj,	XmGadget and XmLabelGadget.

       The class pointer is xmPushButtonGadgetClass.

       The class name is XmPushButtonGadget.

   New Resources
       The following table defines a set of widget resources used by the  pro-
       grammer	to specify data. The programmer	can also set the resource val-
       ues 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 XmN or XmC prefix and use the remaining letters. To specify one  of
       the  defined  values for	a resource in a	.Xdefaults file, remove	the Xm
       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 XtSetValues	(S), retrieved by using	XtGetValues (G), or is
       not applicable (N/A).

       +-------------------------------------------------------------------------------------------------------------------+
       |				|	 XmPushButtonGadget Resource Set	   |			  |	   |
       |Name				| Class				  | Type	   | Default		  | Access |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNactivateCallback		| XmCCallback			  | XtCallbackList | NULL		  | C	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNarmCallback			| XmCCallback			  | XtCallbackList | NULL		  | C	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNarmColor			| XmCArmColor			  | Pixel	   | dynamic		  | CSG	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNarmPixmap			| XmCArmPixmap			  | Pixmap	   | XmUNSPECIFIED_PIXMAP | CSG	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNdefaultButtonShadowThickness	| XmCdefaultButtonShadowThickness | Dimension	   | dynamic		  | CSG	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNdisarmCallback		| XmCCallback			  | XtCallbackList | NULL		  | C	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNfillOnArm			| XmCFillOnArm			  | Boolean	   | True		  | CSG	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNmultiClick			| XmCMultiClick			  | unsigned char  | dynamic		  | CSG	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       |XmNshowAsDefault		| XmCShowAsDefault		  | Dimension	   | 0			  | CSG	   |
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       +--------------------------------+---------------------------------+----------------+----------------------+--------+
       XmNactivateCallback
		 Specifies the list of callbacks that is called	when the Push-
		 ButtonGadget  is  activated.	It  is activated when the user
		 presses and  releases	the  active  mouse  button  while  the
		 pointer  is  inside the PushButtonGadget. Activating PushBut-
		 tonGadget also	disarms	it.  For this callback,	the reason  is
		 XmCR_ACTIVATE.	 This callback uses the	XmQTactivatable	trait.

       XmNarmCallback
		 Specifies  the	list of	callbacks that is called when PushBut-
		 tonGadget is armed.  It is armed when the  user  presses  the
		 active	 mouse button while the	pointer	is inside the PushBut-
		 tonGadget.  For this callback,	the reason is XmCR_ARM.

       XmNarmColor
		 Specifies the color with which	to fill	the armed button.  Xm-
		 NfillOnArm  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.

       XmNarmPixmap
		 Specifies the pixmap to be used as the	button face if	XmNla-
		 beltype is XmPIXMAP or	XmPIXMAP_AND_STRING and	PushButtonGad-
		 get is	armed.	This resource is disabled when the PushButton-
		 Gadget	is in a	menu.

       XmNdefaultButtonShadowThickness
		 This resource specifies the width of the default button indi-
		 cator shadow.	If this	resource is 0 (zero), the width	of the
		 shadow	comes from the value of	the XmNshowAsDefault resource.
		 If this resource is greater than zero,	 the  XmNshowAsDefault
		 resource  is  only used to specify whether this button	is the
		 default.  The default value is	 the  initial  value  of  XmN-
		 showAsDefault.

       XmNdisarmCallback
		 Specifies the list of callbacks that is called	when the Push-
		 ButtonGadget is disarmed.  PushButtonGadget is	disarmed  when
		 the  user  presses and	releases the active mouse button while
		 the pointer is	inside that gadget.  For  this	callback,  the
		 reason	is XmCR_DISARM.

       XmNfillOnArm
		 Forces	 the  PushButtonGadget	to  fill the background	of the
		 button	with the color specified by XmNarmColor	when the  but-
		 ton  is armed and when	this resource is set to	True. If it is
		 False,	only the top and bottom	shadow	colors	are  switched.
		 When  the PushButtonGadget is in a menu, this resource	is ig-
		 nored and assumed to be False.

       XmNmultiClick
		 If a button click is followed by another button click	within
		 the time span specified by the	display's multiclick time, and
		 this resource is  set	to  XmMULTICLICK_DISCARD,  the	second
		 click	is  not	 processed.  If	this resource is set to	XmMUL-
		 TICLICK_KEEP, the event is processed and click_count  is  in-
		 cremented in the callback structure.  When the	button is in a
		 menu, the default is XmMULTICLICK_DISCARD; otherwise,	for  a
		 button	not in a menu, the default value is XmMULTICLICK_KEEP.

       XmNshowAsDefault
		 If  XmNdefaultButtonShadowThickness is	greater	than 0 (zero),
		 a value greater than zero in this resource specifies to  mark
		 this  button as the default button.  If XmNdefaultButtonShad-
		 owThickness is	0, a value greater than	 0  in	this  resource
		 specifies  to mark this button	as the default button with the
		 shadow	thickness specified by this resource.  The  space  be-
		 tween	the  shadow and	the default shadow is equal to the sum
		 of both shadows.  The default value is	0.  When  the  Display
		 resource  XmNdefaultButtonEmphasis  has  a  value of XmEXTER-
		 NAL_HIGHLIGHT (the default), PushButton  draws	 the  location
		 cursor	 outside of the	outer shadow. When this	resource has a
		 value of XmINTERNAL_HIGHLIGHT,	the highlight is drawn between
		 the  inner  and outer shadows.	 When this value is not	0, the
		 Label XmNmarginLeft, XmNmarginRight, XmNmarginTop,  and  XmN-
		 marginBottom  resources  may  be  modified to accommodate the
		 second	shadow.	 This resource is disabled when	the PushButton
		 is in a menu.

   Inherited Resources
       PushButtonGadget	 inherits behavior and resources from the superclasses
       described in the	following tables.  For a complete description of  each
       resource, refer to the reference	page for that superclass.

       +----------------------------------------------------------------------------------------------------------+
       |			  |	       XmLabelGadget Resource Set	  |			 |	  |
       |Name			  | Class		      |	Type		  | Default		 | Access |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNaccelerator		  | XmCAccelerator	      |	String		  | NULL		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNacceleratorText	  | XmCAcceleratorText	      |	XmString	  | NULL		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNalignment		  | XmCAlignment	      |	unsigned char	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNfontList		  | XmCFontList		      |	XmFontList	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNlabelInsensitivePixmap | XmCLabelInsensitivePixmap |	Pixmap		  | XmUNSPECIFIED_PIXMAP | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNlabelPixmap		  | XmCLabelPixmap	      |	Pixmap		  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNlabelString		  | XmCXmString		      |	XmString	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNlabelType		  | XmCLabelType	      |	unsigned char	  | XmSTRING		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmarginBottom		  | XmCMarginBottom	      |	Dimension	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmarginHeight		  | XmCMarginHeight	      |	Dimension	  | 2			 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmarginLeft		  | XmCMarginLeft	      |	Dimension	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmarginRight		  | XmCMarginRight	      |	Dimension	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmarginTop		  | XmCMarginTop	      |	Dimension	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmarginWidth		  | XmCMarginWidth	      |	Dimension	  | 2			 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmnemonic		  | XmCMnemonic		      |	KeySym		  | NULL		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNpixmapPlacement	  | XmCPixmapPlacement	      |	unsigned int	  | XmPIXMAP_LEFT	 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNpixmapTextPadding	  | XmCSpace		      |	Dimension	  | 2			 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNmnemonicCharSet	  | XmCMnemonicCharSet	      |	String		  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNrecomputeSize	  | XmCRecomputeSize	      |	Boolean		  | True		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNrenderTable		  | XmCRenderTable	      |	XmRenderTable	  | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       |XmNstringDirection	  | XmCStringDirection	      |	XmStringDirection | dynamic		 | CSG	  |
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       +--------------------------+---------------------------+-------------------+----------------------+--------+
       +-------------------------------------------------------------------------------------------------+
       |		      |		     XmGadget Resource Set	 |			|	 |
       |Name		      |	Class		      |	Type		 | Default		| Access |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNbackground	      |	XmCBackground	      |	Pixel		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNbackgroundPixmap   |	XmCPixmap	      |	Pixmap		 | XmUNSPECIFIED_PIXMAP	| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNbottomShadowColor  |	XmCBottomShadowColor  |	Pixel		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNbottomShadowPixmap |	XmCBottomShadowPixmap |	Pixmap		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNhelpCallback	      |	XmCCallback	      |	XtCallbackList	 | NULL			| C	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNforeground	      |	XmCForeground	      |	Pixel		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightColor     |	XmCHighlightColor     |	Pixel		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightOnEnter   |	XmCHighlightOnEnter   |	Boolean		 | False		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightPixmap    |	XmCHighlightPixmap    |	Pixmap		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNhighlightThickness |	XmCHighlightThickness |	Dimension	 | 2			| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNlayoutDirection    |	XmNCLayoutDirection   |	XmDirection	 | dynamic		| CG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNnavigationType     |	XmCNavigationType     |	XmNavigationType | XmNONE		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNshadowThickness    |	XmCShadowThickness    |	Dimension	 | 2			| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNtopShadowColor     |	XmCTopShadowColor     |	Pixel		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNtopShadowPixmap    |	XmCTopShadowPixmap    |	Pixmap		 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNtraversalOn	      |	XmCTraversalOn	      |	Boolean		 | True			| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNunitType	      |	XmCUnitType	      |	unsigned char	 | dynamic		| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       |XmNuserData	      |	XmCUserData	      |	XtPointer	 | NULL			| CSG	 |
       +----------------------+-----------------------+------------------+----------------------+--------+
       +----------------------+-----------------------+------------------+----------------------+--------+
       +---------------------------------------------------------------------+
       |		     |	RectObj	Resource Set	  |	    |	     |
       |Name		     | Class	      |	Type	  | Default | Access |
       +---------------------+----------------+-----------+---------+--------+
       |XmNancestorSensitive | XmCSensitive   |	Boolean	  | dynamic | G	     |
       +---------------------+----------------+-----------+---------+--------+
       |XmNborderWidth	     | XmCBorderWidth |	Dimension | 0	    | N/A    |
       +---------------------+----------------+-----------+---------+--------+
       |XmNheight	     | XmCHeight      |	Dimension | dynamic | CSG    |
       +---------------------+----------------+-----------+---------+--------+
       |XmNsensitive	     | XmCSensitive   |	Boolean	  | True    | CSG    |
       +---------------------+----------------+-----------+---------+--------+
       |XmNwidth	     | XmCWidth	      |	Dimension | dynamic | CSG    |
       +---------------------+----------------+-----------+---------+--------+
       |XmNx		     | XmCPosition    |	Position  | 0	    | CSG    |
       +---------------------+----------------+-----------+---------+--------+
       |XmNy		     | XmCPosition    |	Position  | 0	    | CSG    |
       +---------------------+----------------+-----------+---------+--------+
       +---------------------+----------------+-----------+---------+--------+
       +---------------------------------------------------------------------+
       |		   |	Object Resource	Set	  |	    |	     |
       |Name		   | Class	 | Type		  | Default | Access |
       +-------------------+-------------+----------------+---------+--------+
       |XmNdestroyCallback | XmCCallback | XtCallbackList | NULL    | C	     |
       +-------------------+-------------+----------------+---------+--------+
       +-------------------+-------------+----------------+---------+--------+
   Callback Information
       A pointer to the	following structure is passed to each callback:

       typedef struct
       {
	       int reason;
	       XEvent *	event;
	       int click_count;
       } XmPushButtonCallbackStruct;

       reason	 Indicates why the callback was	invoked.

       event	 Points	to the XEvent that triggered the callback.

       click_count
		 Valid only when the reason is XmCR_ACTIVATE.  It contains the
		 number	of clicks in the last multiclick sequence if the  XmN-
		 multiClick resource is	set to XmMULTICLICK_KEEP; otherwise it
		 contains 1.  The activate callback is invoked for each	 click
		 if XmNmultiClick is set to XmMULTICLICK_KEEP.

   Behavior
       XmPushButtonGadget includes behavior from XmGadget.  XmPushButtonGadget
       includes	menu traversal behavior	from XmLabelGadget.  Additional	behav-
       ior for XmPushButtonGadget is described in the following	list.

       <Btn2Down>:
		 Drags	the  contents  of a PushButtonGadget label, identified
		 when <Btn2> is	pressed.  This action is undefined  for	 Push-
		 ButtonGadgets used in a menu system.

       <Btn1Down>:
		 This action arms the PushButtonGadget.

		 In  a menu, this action unposts any menus posted by the Push-
		 ButtonGadget's	parent menu, disables keyboard	traversal  for
		 the menu, and enables mouse traversal for the menu.  It draws
		 the shadow in the armed state.	 Unless	the button is  already
		 armed,	it calls the XmNarmCallback callbacks.

		 If  the button	is not in a menu, this action draws the	shadow
		 in the	armed state.  If XmNfillOnArm is set to	True, it fills
		 the  button with the color specified by XmNarmColor.  If XmN-
		 labelType  is	XmPIXMAP  or  XmPIXMAP_AND_STRING,  the	  XmN-
		 armPixmap  is used for	the button face.  It calls the XmNarm-
		 Callback callbacks.

       <Btn1>(2+):
		 If XmNmultiClick is XmMULTICLICK_DISCARD,  this  action  does
		 nothing.

		 If  XmNmultiClick is XmMULTICLICK_KEEP, this action draws the
		 shadow	in the armed state.  If	the button is not  in  a  menu
		 and  if XmNfillOnArm is set to	True, it fills the button with
		 the color  specified  by  XmNarmColor.	  If  XmNlabelType  is
		 XmPIXMAP or XmPIXMAP_AND_STRING, the XmNarmPixmap is used for
		 the button face.  This	action calls the XmNarmCallback	 call-
		 backs.

       <Btn1Up>: In  a menu, this action unposts all menus in the menu hierar-
		 chy and activates the PushButtonGadget.  It calls the	XmNac-
		 tivateCallback	callbacks and then the XmNdisarmCallback call-
		 backs.

		 If the	PushButtonGadget is not	in a menu, this	 action	 draws
		 the  shadow  in the unarmed state.  If	XmNfillOnArm is	set to
		 True, the background color reverts to the unarmed color.   If
		 XmNlabelType  is  XmPIXMAP or XmPIXMAP_AND_STRING, the	XmNla-
		 belPixmap is used for the button face.	  If  the  pointer  is
		 still	within the button, this	action calls the callbacks for
		 XmNactivateCallback and XmNdisarmCallback.

       <Btn1Up>(2+):
		 If XmNmultiClick is XmMULTICLICK_DISCARD,  this  action  does
		 nothing.

		 If XmNmultiClick is XmMULTICLICK_KEEP,	this action increments
		 click_count in	the callback structure and draws the shadow in
		 the unarmed state.  If	the button is not in a menu and	if Xm-
		 NfillOnArm is set to True, the	background  color  reverts  to
		 the   unarmed	 color.	   If	XmNlabelType  is  XmPIXMAP  or
		 XmPIXMAP_AND_STRING, XmNlabelPixmap is	used  for  the	button
		 face.	 If  the  pointer is within the	PushButtonGadget, this
		 action	calls the callbacks for	 XmNactivateCallback  and  Xm-
		 NdisarmCallback.

       <Key><osfActivate>:
		 In  a menu, this action unposts all menus in the menu hierar-
		 chy, unless the button	is already armed, and calls  the  XmN-
		 armCallback  callbacks,  the  XmNactivateCallback and the Xm-
		 NdisarmCallback callbacks. Outside a menu, KActivate  has  no
		 effect.  For PushButtonGadgets	outside	of a menu, if the par-
		 ent is	a manager, this	action passes the event	to the parent.

       <Key><osfSelect>:
		 In a menu, this action	unposts	all menus in the menu  hierar-
		 chy,  unless  the button is already armed, and	calls the XmN-
		 armCallback callbacks.	 This acton calls the XmNactivateCall-
		 back and XmNdisarmCallback callbacks.

		 Outside  a  menu,  this  action draws the shadow in the armed
		 state and, if XmNfillOnArm is set to True, fills  the	button
		 with  the color specified by XmNarmColor.  If XmNlabelType is
		 XmPIXMAP or XmPIXMAP_AND_STRING, XmNarmPixmap is used for the
		 button	face.  This action calls the XmNarmCallback 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	XmNfillOnArm is	set to
		 True, the background color reverts to the unarmed color.   If
		 XmNlabelType  is  XmPIXMAP or XmPIXMAP_AND_STRING, the	XmNla-
		 belPixmap is used for the button face.	 The  XmNactivateCall-
		 back and XmNdisarmCallback callbacks are called.

       <Key><osfHelp>:
		 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.  This ac-
		 tion calls the	callbacks for XmNhelpCallback  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.

       <Key><osfCancel>:
		 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 be-
		 fore 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.	For  a
		 PushButtonGadget  outside  of	a  menu,  if  the  parent is a
		 manger, this action passes the	event to the parent.

       <Enter>:	 In a menu, if keyboard	traversal is enabled, this action does
		 nothing.   Otherwise,	it draws the shadow in the armed state
		 and calls the XmNarmCallback callbacks.

		 If the	PushButtonGadget is not	 in  a	menu  and  the	cursor
		 leaves	 and then reenters the PushButtonGadget	while the but-
		 ton is	pressed, this action draws the	shadow	in  the	 armed
		 state.	  If  XmNfillOnArm  is	set to True, it	also fills the
		 button	with the color specified by XmNarmColor.  If XmNlabel-
		 Type  is XmPIXMAP or XmPIXMAP_AND_STRING, the XmNarmPixmap is
		 used for the button face.

       <Leave>:	 In a menu, if keyboard	traversal is enabled, this action does
		 nothing.  Otherwise, it draws the shadow in the unarmed state
		 and calls the XmNdisarmCallback callbacks.

		 If the	PushButtonGadget is not	 in  a	menu  and  the	cursor
		 leaves	the PushButtonGadget while the button is pressed, this
		 action	draws the shadow in the	unarmed	state.	If  XmNfillOn-
		 Arm  is  set to True, the background color reverts to the un-
		 armed	 color.	    If	  XmNlabelType	  is	XmPIXMAP    or
		 XmPIXMAP_AND_STRING,  the XmNlabelPixmap 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	VirtualBindings(3).

RELATED
       Object(3),  RectObj(3), XmCreatePushButtonGadget(3), XmGadget(3), XmLa-
       belGadget(3), XmRowColumn(3),  XmVaCreatePushButtonGadget(3),  and  Xm-
       VaCreateManagedPushButtonGadget(3).

							 XmPushButtonGadget(3)

NAME | SYNOPSIS | DESCRIPTION | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmPushButtonGadget&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help