1XmPushButtonGadget(library call)              XmPushButtonGadget(library call)
2
3
4

NAME

6       XmPushButtonGadget — The PushButtonGadget widget class
7

SYNOPSIS

9       #include <Xm/PushBG.h>
10

DESCRIPTION

12       PushButtonGadget issues commands within an application.  It consists of
13       a text label or pixmap surrounded by a border shadow.  When PushButton‐
14       Gadget  is selected, the shadow changes to give the appearance that the
15       PushButtonGadget has been pressed in. When  PushButtonGadget  is  unse‐
16       lected,  the shadow changes to give the appearance that the PushButton‐
17       Gadget is out.
18
19       The default behavior associated  with  a  PushButtonGadget  in  a  menu
20       depends  on  the  type of menu system in which it resides.  By default,
21       <Btn1> controls the behavior of  the  PushButtonGadget.   In  addition,
22       <Btn3> controls the behavior of the PushButtonGadget if it resides in a
23       PopupMenu system.  The actual mouse button used is  determined  by  its
24       RowColumn parent.
25
26       Thickness  for  a  second shadow may be specified with the XmNshowAsDe‐
27       fault resource. If it has a nonzero value, the  Label's  XmNmarginLeft,
28       XmNmarginRight, XmNmarginTop, and XmNmarginBottom resources may be mod‐
29       ified to accommodate the second shadow.
30
31       If an initial value is specified for XmNarmPixmap but  not  for  XmNla‐
32       belPixmap, the XmNarmPixmap value is used for XmNlabelPixmap.
33
34       PushButtonGadget  uses  the  XmQTmenuSystem  and XmQTspecifyRenderTable
35       traits, and holds the XmQactivatable, XmQTmenuSavvy,  and  XmQTtakesDe‐
36       fault traits.
37
38   Classes
39       PushButtonGadget  inherits behavior, resources, and traits from Object,
40       RectObj, XmGadget and XmLabelGadget.
41
42       The class pointer is xmPushButtonGadgetClass.
43
44       The class name is XmPushButtonGadget.
45
46   New Resources
47       The following table defines a set of widget resources used by the  pro‐
48       grammer  to specify data. The programmer can also set the resource val‐
49       ues for the inherited classes to set attributes  for  this  widget.  To
50       reference  a  resource by name or by class in a .Xdefaults file, remove
51       the XmN or XmC prefix and use the remaining letters. To specify one  of
52       the  defined  values for a resource in a .Xdefaults file, remove the Xm
53       prefix and use the remaining letters (in either lowercase or uppercase,
54       but  include  any  underscores between words).  The codes in the access
55       column indicate if the given resource can be set at creation time  (C),
56       set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
57       not applicable (N/A).
58
59       ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
60       │                                │        XmPushButtonGadget Resour│ce Set           │                      │        │
61Name                            Class                           Type           Default              Access 
62       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
63       │XmNactivateCallback             │ XmCCallback                     │ XtCallbackList │ NULL                 │ C      │
64       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
65       │XmNarmCallback                  │ XmCCallback                     │ XtCallbackList │ NULL                 │ C      │
66       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
67       │XmNarmColor                     │ XmCArmColor                     │ Pixel          │ dynamic              │ CSG    │
68       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
69       │XmNarmPixmap                    │ XmCArmPixmap                    │ Pixmap         │ XmUNSPECIFIED_PIXMAP │ CSG    │
70       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
71       │XmNdefaultButtonShadowThickness │ XmCdefaultButtonShadowThickness │ Dimension      │ dynamic              │ CSG    │
72       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
73       │XmNdisarmCallback               │ XmCCallback                     │ XtCallbackList │ NULL                 │ C      │
74       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
75       │XmNfillOnArm                    │ XmCFillOnArm                    │ Boolean        │ True                 │ CSG    │
76       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
77       │XmNmultiClick                   │ XmCMultiClick                   │ unsigned char  │ dynamic              │ CSG    │
78       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
79       │XmNshowAsDefault                │ XmCShowAsDefault                │ Dimension      │ 0                    │ CSG    │
80       ├────────────────────────────────┼─────────────────────────────────┼────────────────┼──────────────────────┼────────┤
81       └────────────────────────────────┴─────────────────────────────────┴────────────────┴──────────────────────┴────────┘
82       XmNactivateCallback
83                 Specifies the list of callbacks that is called when the Push‐
84                 ButtonGadget  is  activated.   It  is activated when the user
85                 presses and  releases  the  active  mouse  button  while  the
86                 pointer  is  inside the PushButtonGadget. Activating PushBut‐
87                 tonGadget also disarms it.  For this callback, the reason  is
88                 XmCR_ACTIVATE.  This callback uses the XmQTactivatable trait.
89
90       XmNarmCallback
91                 Specifies  the list of callbacks that is called when PushBut‐
92                 tonGadget is armed.  It is armed when the  user  presses  the
93                 active  mouse button while the pointer is inside the PushBut‐
94                 tonGadget.  For this callback, the reason is XmCR_ARM.
95
96       XmNarmColor
97                 Specifies the color with which  to  fill  the  armed  button.
98                 XmNfillOnArm must be set to True for this resource to have an
99                 effect.  The default for a color display is a  color  between
100                 the  background and the bottom shadow color. For a monochrome
101                 display, the default is set to the foreground color, and  any
102                 text  in  the  label appears in the background color when the
103                 button is armed.
104
105       XmNarmPixmap
106                 Specifies the pixmap to be used as the button face if  XmNla‐
107                 beltype is XmPIXMAP or XmPIXMAP_AND_STRING and PushButtonGad‐
108                 get is armed.  This resource is disabled when the PushButton‐
109                 Gadget is in a menu.
110
111       XmNdefaultButtonShadowThickness
112                 This resource specifies the width of the default button indi‐
113                 cator shadow.  If this resource is 0 (zero), the width of the
114                 shadow comes from the value of the XmNshowAsDefault resource.
115                 If this resource is greater than zero,  the  XmNshowAsDefault
116                 resource  is  only used to specify whether this button is the
117                 default.  The default value is  the  initial  value  of  XmN‐
118                 showAsDefault.
119
120       XmNdisarmCallback
121                 Specifies the list of callbacks that is called when the Push‐
122                 ButtonGadget is disarmed.  PushButtonGadget is disarmed  when
123                 the  user  presses and releases the active mouse button while
124                 the pointer is inside that gadget.  For  this  callback,  the
125                 reason is XmCR_DISARM.
126
127       XmNfillOnArm
128                 Forces  the  PushButtonGadget  to  fill the background of the
129                 button with the color specified by XmNarmColor when the  but‐
130                 ton  is armed and when this resource is set to True. If it is
131                 False, only the top and bottom shadow  colors  are  switched.
132                 When  the  PushButtonGadget  is  in  a menu, this resource is
133                 ignored and assumed to be False.
134
135       XmNmultiClick
136                 If a button click is followed by another button click  within
137                 the time span specified by the display's multiclick time, and
138                 this resource is  set  to  XmMULTICLICK_DISCARD,  the  second
139                 click  is  not  processed.  If this resource is set to XmMUL‐
140                 TICLICK_KEEP, the  event  is  processed  and  click_count  is
141                 incremented in the callback structure.  When the button is in
142                 a menu, the default is XmMULTICLICK_DISCARD; otherwise, for a
143                 button not in a menu, the default value is XmMULTICLICK_KEEP.
144
145       XmNshowAsDefault
146                 If  XmNdefaultButtonShadowThickness is greater than 0 (zero),
147                 a value greater than zero in this resource specifies to  mark
148                 this  button as the default button.  If XmNdefaultButtonShad‐
149                 owThickness is 0, a value greater than  0  in  this  resource
150                 specifies  to mark this button as the default button with the
151                 shadow thickness  specified  by  this  resource.   The  space
152                 between the shadow and the default shadow is equal to the sum
153                 of both shadows.  The default value is 0.  When  the  Display
154                 resource  XmNdefaultButtonEmphasis  has  a  value of XmEXTER‐
155                 NAL_HIGHLIGHT (the default), PushButton  draws  the  location
156                 cursor  outside of the outer shadow. When this resource has a
157                 value of XmINTERNAL_HIGHLIGHT, the highlight is drawn between
158                 the  inner  and outer shadows.  When this value is not 0, the
159                 Label XmNmarginLeft, XmNmarginRight, XmNmarginTop,  and  XmN‐
160                 marginBottom  resources  may  be  modified to accommodate the
161                 second shadow.  This resource is disabled when the PushButton
162                 is in a menu.
163
164   Inherited Resources
165       PushButtonGadget  inherits behavior and resources from the superclasses
166       described in the following tables.  For a complete description of  each
167       resource, refer to the reference page for that superclass.
168
169       ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────┐
170       │                          │            XmLabelGadget R│esource Set         │                      │        │
171Name                      Class                     Type              Default              Access 
172       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
173       │XmNaccelerator            │ XmCAccelerator            │ String            │ NULL                 │ CSG    │
174       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
175       │XmNacceleratorText        │ XmCAcceleratorText        │ XmString          │ NULL                 │ CSG    │
176       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
177       │XmNalignment              │ XmCAlignment              │ unsigned char     │ dynamic              │ CSG    │
178       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
179       │XmNfontList               │ XmCFontList               │ XmFontList        │ dynamic              │ CSG    │
180       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
181       │XmNlabelInsensitivePixmap │ XmCLabelInsensitivePixmap │ Pixmap            │ XmUNSPECIFIED_PIXMAP │ CSG    │
182       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
183       │XmNlabelPixmap            │ XmCLabelPixmap            │ Pixmap            │ dynamic              │ CSG    │
184       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
185       │XmNlabelString            │ XmCXmString               │ XmString          │ dynamic              │ CSG    │
186       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
187       │XmNlabelType              │ XmCLabelType              │ unsigned char     │ XmSTRING             │ CSG    │
188       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
189       │XmNmarginBottom           │ XmCMarginBottom           │ Dimension         │ dynamic              │ CSG    │
190       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
191       │XmNmarginHeight           │ XmCMarginHeight           │ Dimension         │ 2                    │ CSG    │
192       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
193       │XmNmarginLeft             │ XmCMarginLeft             │ Dimension         │ dynamic              │ CSG    │
194       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
195       │XmNmarginRight            │ XmCMarginRight            │ Dimension         │ dynamic              │ CSG    │
196       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
197       │XmNmarginTop              │ XmCMarginTop              │ Dimension         │ dynamic              │ CSG    │
198       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
199       │XmNmarginWidth            │ XmCMarginWidth            │ Dimension         │ 2                    │ CSG    │
200       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
201       │XmNmnemonic               │ XmCMnemonic               │ KeySym            │ NULL                 │ CSG    │
202       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
203       │XmNpixmapPlacement        │ XmCPixmapPlacement        │ unsigned int      │ XmPIXMAP_LEFT        │ CSG    │
204       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
205       │XmNpixmapTextPadding      │ XmCSpace                  │ Dimension         │ 2                    │ CSG    │
206       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
207       │XmNmnemonicCharSet        │ XmCMnemonicCharSet        │ String            │ dynamic              │ CSG    │
208       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
209       │XmNrecomputeSize          │ XmCRecomputeSize          │ Boolean           │ True                 │ CSG    │
210       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
211       │XmNrenderTable            │ XmCRenderTable            │ XmRenderTable     │ dynamic              │ CSG    │
212       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
213       │XmNstringDirection        │ XmCStringDirection        │ XmStringDirection │ dynamic              │ CSG    │
214       ├──────────────────────────┼───────────────────────────┼───────────────────┼──────────────────────┼────────┤
215       └──────────────────────────┴───────────────────────────┴───────────────────┴──────────────────────┴────────┘
216       ┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
217       │                      │              XmGadget │Resource Set       │                      │        │
218Name                  Class                 Type             Default              Access 
219       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
220       │XmNbackground         │ XmCBackground         │ Pixel            │ dynamic              │ CSG    │
221       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
222       │XmNbackgroundPixmap   │ XmCPixmap             │ Pixmap           │ XmUNSPECIFIED_PIXMAP │ CSG    │
223       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
224       │XmNbottomShadowColor  │ XmCBottomShadowColor  │ Pixel            │ dynamic              │ CSG    │
225       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
226       │XmNbottomShadowPixmap │ XmCBottomShadowPixmap │ Pixmap           │ dynamic              │ CSG    │
227       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
228       │XmNhelpCallback       │ XmCCallback           │ XtCallbackList   │ NULL                 │ C      │
229       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
230       │XmNforeground         │ XmCForeground         │ Pixel            │ dynamic              │ CSG    │
231       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
232       │XmNhighlightColor     │ XmCHighlightColor     │ Pixel            │ dynamic              │ CSG    │
233       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
234       │XmNhighlightOnEnter   │ XmCHighlightOnEnter   │ Boolean          │ False                │ CSG    │
235       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
236       │XmNhighlightPixmap    │ XmCHighlightPixmap    │ Pixmap           │ dynamic              │ CSG    │
237       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
238       │XmNhighlightThickness │ XmCHighlightThickness │ Dimension        │ 2                    │ CSG    │
239       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
240       │XmNlayoutDirection    │ XmNCLayoutDirection   │ XmDirection      │ dynamic              │ CG     │
241       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
242       │XmNnavigationType     │ XmCNavigationType     │ XmNavigationType │ XmNONE               │ CSG    │
243       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
244       │XmNshadowThickness    │ XmCShadowThickness    │ Dimension        │ 2                    │ CSG    │
245       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
246       │XmNtopShadowColor     │ XmCTopShadowColor     │ Pixel            │ dynamic              │ CSG    │
247       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
248       │XmNtopShadowPixmap    │ XmCTopShadowPixmap    │ Pixmap           │ dynamic              │ CSG    │
249       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
250       │XmNtraversalOn        │ XmCTraversalOn        │ Boolean          │ True                 │ CSG    │
251       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
252       │XmNunitType           │ XmCUnitType           │ unsigned char    │ dynamic              │ CSG    │
253       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
254       │XmNuserData           │ XmCUserData           │ XtPointer        │ NULL                 │ CSG    │
255       ├──────────────────────┼───────────────────────┼──────────────────┼──────────────────────┼────────┤
256       └──────────────────────┴───────────────────────┴──────────────────┴──────────────────────┴────────┘
257       ┌─────────────────────────────────────────────────────────────────────┐
258       │                     │  RectObj Resour│ce Set      │         │        │
259Name                 Class          Type      Default Access 
260       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
261       │XmNancestorSensitive │ XmCSensitive   │ Boolean   │ dynamic │ G      │
262       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
263       │XmNborderWidth       │ XmCBorderWidth │ Dimension │ 0       │ N/A    │
264       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
265       │XmNheight            │ XmCHeight      │ Dimension │ dynamic │ CSG    │
266       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
267       │XmNsensitive         │ XmCSensitive   │ Boolean   │ True    │ CSG    │
268       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
269       │XmNwidth             │ XmCWidth       │ Dimension │ dynamic │ CSG    │
270       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
271       │XmNx                 │ XmCPosition    │ Position  │ 0       │ CSG    │
272       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
273       │XmNy                 │ XmCPosition    │ Position  │ 0       │ CSG    │
274       ├─────────────────────┼────────────────┼───────────┼─────────┼────────┤
275       └─────────────────────┴────────────────┴───────────┴─────────┴────────┘
276       ┌─────────────────────────────────────────────────────────────────────┐
277       │                   │    Object Re│source Set       │         │        │
278Name               Class       Type           Default Access 
279       ├───────────────────┼─────────────┼────────────────┼─────────┼────────┤
280       │XmNdestroyCallback │ XmCCallback │ XtCallbackList │ NULL    │ C      │
281       ├───────────────────┼─────────────┼────────────────┼─────────┼────────┤
282       └───────────────────┴─────────────┴────────────────┴─────────┴────────┘
283   Callback Information
284       A pointer to the following structure is passed to each callback:
285
286       typedef struct
287       {
288               int reason;
289               XEvent * event;
290               int click_count;
291       } XmPushButtonCallbackStruct;
292
293       reason    Indicates why the callback was invoked.
294
295       event     Points to the XEvent that triggered the callback.
296
297       click_count
298                 Valid only when the reason is XmCR_ACTIVATE.  It contains the
299                 number of clicks in the last multiclick sequence if the  XmN‐
300                 multiClick resource is set to XmMULTICLICK_KEEP; otherwise it
301                 contains 1.  The activate callback is invoked for each  click
302                 if XmNmultiClick is set to XmMULTICLICK_KEEP.
303
304   Behavior
305       XmPushButtonGadget includes behavior from XmGadget.  XmPushButtonGadget
306       includes menu traversal behavior from XmLabelGadget.  Additional behav‐
307       ior for XmPushButtonGadget is described in the following list.
308
309       <Btn2Down>:
310                 Drags  the  contents  of a PushButtonGadget label, identified
311                 when <Btn2> is pressed.  This action is undefined  for  Push‐
312                 ButtonGadgets used in a menu system.
313
314       <Btn1Down>:
315                 This action arms the PushButtonGadget.
316
317                 In  a menu, this action unposts any menus posted by the Push‐
318                 ButtonGadget's parent menu, disables keyboard  traversal  for
319                 the menu, and enables mouse traversal for the menu.  It draws
320                 the shadow in the armed state.  Unless the button is  already
321                 armed, it calls the XmNarmCallback callbacks.
322
323                 If  the button is not in a menu, this action draws the shadow
324                 in the armed state.  If XmNfillOnArm is set to True, it fills
325                 the  button with the color specified by XmNarmColor.  If XmN‐
326                 labelType  is  XmPIXMAP  or  XmPIXMAP_AND_STRING,  the   XmN‐
327                 armPixmap  is used for the button face.  It calls the XmNarm‐
328                 Callback callbacks.
329
330       <Btn1>(2+):
331                 If XmNmultiClick is XmMULTICLICK_DISCARD,  this  action  does
332                 nothing.
333
334                 If  XmNmultiClick is XmMULTICLICK_KEEP, this action draws the
335                 shadow in the armed state.  If the button is not  in  a  menu
336                 and  if XmNfillOnArm is set to True, it fills the button with
337                 the color  specified  by  XmNarmColor.   If  XmNlabelType  is
338                 XmPIXMAP or XmPIXMAP_AND_STRING, the XmNarmPixmap is used for
339                 the button face.  This action calls the XmNarmCallback  call‐
340                 backs.
341
342       <Btn1Up>: In  a menu, this action unposts all menus in the menu hierar‐
343                 chy and activates the PushButtonGadget.  It calls the  XmNac‐
344                 tivateCallback callbacks and then the XmNdisarmCallback call‐
345                 backs.
346
347                 If the PushButtonGadget is not in a menu, this  action  draws
348                 the  shadow  in the unarmed state.  If XmNfillOnArm is set to
349                 True, the background color reverts to the unarmed color.   If
350                 XmNlabelType  is  XmPIXMAP or XmPIXMAP_AND_STRING, the XmNla‐
351                 belPixmap is used for the button face.   If  the  pointer  is
352                 still  within the button, this action calls the callbacks for
353                 XmNactivateCallback and XmNdisarmCallback.
354
355       <Btn1Up>(2+):
356                 If XmNmultiClick is XmMULTICLICK_DISCARD,  this  action  does
357                 nothing.
358
359                 If XmNmultiClick is XmMULTICLICK_KEEP, this action increments
360                 click_count in the callback structure and draws the shadow in
361                 the  unarmed  state.   If  the button is not in a menu and if
362                 XmNfillOnArm is set to True, the background color reverts  to
363                 the   unarmed   color.    If   XmNlabelType  is  XmPIXMAP  or
364                 XmPIXMAP_AND_STRING, XmNlabelPixmap is used  for  the  button
365                 face.   If  the  pointer is within the PushButtonGadget, this
366                 action  calls  the  callbacks  for  XmNactivateCallback   and
367                 XmNdisarmCallback.
368
369       <Key><osfActivate>:
370                 In  a menu, this action unposts all menus in the menu hierar‐
371                 chy, unless the button is already armed, and calls  the  XmN‐
372                 armCallback   callbacks,   the  XmNactivateCallback  and  the
373                 XmNdisarmCallback callbacks. Outside a menu, KActivate has no
374                 effect.  For PushButtonGadgets outside of a menu, if the par‐
375                 ent is a manager, this action passes the event to the parent.
376
377       <Key><osfSelect>:
378                 In a menu, this action unposts all menus in the menu  hierar‐
379                 chy,  unless  the button is already armed, and calls the XmN‐
380                 armCallback callbacks.  This acton calls the XmNactivateCall‐
381                 back and XmNdisarmCallback callbacks.
382
383                 Outside  a  menu,  this  action draws the shadow in the armed
384                 state and, if XmNfillOnArm is set to True, fills  the  button
385                 with  the color specified by XmNarmColor.  If XmNlabelType is
386                 XmPIXMAP or XmPIXMAP_AND_STRING, XmNarmPixmap is used for the
387                 button face.  This action calls the XmNarmCallback callbacks.
388
389                 Outside  a  menu, this action also arranges for the following
390                 to happen, either immediately or at a later time: the  shadow
391                 is  drawn in the unarmed state and, if XmNfillOnArm is set to
392                 True, the background color reverts to the unarmed color.   If
393                 XmNlabelType  is  XmPIXMAP or XmPIXMAP_AND_STRING, the XmNla‐
394                 belPixmap is used for the button face.  The  XmNactivateCall‐
395                 back and XmNdisarmCallback callbacks are called.
396
397       <Key><osfHelp>:
398                 In  a  Pulldown  or  Popup MenuPane, unposts all menus in the
399                 menu hierarchy and restores keyboard focus to the widget that
400                 had  the  focus  before  the  menu  system was entered.  This
401                 action calls the callbacks for XmNhelpCallback if any  exist.
402                 If  there  are no help callbacks for this widget, this action
403                 calls the help callbacks for the nearest  ancestor  that  has
404                 them.
405
406       <Key><osfCancel>:
407                 In  a  toplevel Pulldown MenuPane from a MenuBar, unposts the
408                 menu, disarms the MenuBar CascadeButton and the MenuBar,  and
409                 restores  keyboard  focus  to  the  widget that had the focus
410                 before the MenuBar was entered.  In other Pulldown MenuPanes,
411                 unposts the menu.
412
413                 In  a  Popup MenuPane, unposts the menu and restores keyboard
414                 focus to the widget from which the menu was  posted.   For  a
415                 PushButtonGadget  outside  of  a  menu,  if  the  parent is a
416                 manger, this action passes the event to the parent.
417
418       <Enter>:  In a menu, if keyboard traversal is enabled, this action does
419                 nothing.   Otherwise,  it draws the shadow in the armed state
420                 and calls the XmNarmCallback callbacks.
421
422                 If the PushButtonGadget is not  in  a  menu  and  the  cursor
423                 leaves  and then reenters the PushButtonGadget while the but‐
424                 ton is pressed, this action draws the  shadow  in  the  armed
425                 state.   If  XmNfillOnArm  is  set to True, it also fills the
426                 button with the color specified by XmNarmColor.  If XmNlabel‐
427                 Type  is XmPIXMAP or XmPIXMAP_AND_STRING, the XmNarmPixmap is
428                 used for the button face.
429
430       <Leave>:  In a menu, if keyboard traversal is enabled, this action does
431                 nothing.  Otherwise, it draws the shadow in the unarmed state
432                 and calls the XmNdisarmCallback callbacks.
433
434                 If the PushButtonGadget is not  in  a  menu  and  the  cursor
435                 leaves the PushButtonGadget while the button is pressed, this
436                 action draws the shadow in the unarmed state.  If  XmNfillOn‐
437                 Arm  is  set  to  True,  the  background color reverts to the
438                 unarmed   color.    If   XmNlabelType    is    XmPIXMAP    or
439                 XmPIXMAP_AND_STRING,  the XmNlabelPixmap is used for the but‐
440                 ton face.
441
442   Virtual Bindings
443       The bindings for virtual keys are  vendor  specific.   For  information
444       about bindings for virtual buttons and keys, see VirtualBindings(3).
445
447       Object(3),  RectObj(3), XmCreatePushButtonGadget(3), XmGadget(3), XmLa‐
448       belGadget(3),   XmRowColumn(3),   XmVaCreatePushButtonGadget(3),    and
449       XmVaCreateManagedPushButtonGadget(3).
450
451
452
453                                              XmPushButtonGadget(library call)
Impressum