1XmPushButtonGadget(library call) XmPushButtonGadget(library call)
2
6 XmPushButtonGadget — The PushButtonGadget widget class
7
9 #include <Xm/PushBG.h>
10
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 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 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 If an initial value is specified for XmNarmPixmap but not for XmNla‐
32 belPixmap, the XmNarmPixmap value is used for XmNlabelPixmap.
33 PushButtonGadget uses the XmQTmenuSystem and XmQTspecifyRenderTable
35 traits, and holds the XmQactivatable, XmQTmenuSavvy, and XmQTtakesDe‐
36 fault traits.
37 Classes
39 PushButtonGadget inherits behavior, resources, and traits from Object,
40 RectObj, XmGadget and XmLabelGadget.
41 The class pointer is xmPushButtonGadgetClass.
43 The class name is XmPushButtonGadget.
45 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 ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
60 │ │ XmPushButtonGadget Resour│ce Set │ │ │
61 │Name │ 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 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 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 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 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 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 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 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 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 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 ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────┐
170 │ │ XmLabelGadget R│esource Set │ │ │
171 │Name │ 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 │ │ │
218 │Name │ 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 │ │ │
259 │Name │ 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 │ │ │
278 │Name │ 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 typedef struct
287 {
288 int reason;
289 XEvent * event;
290 int click_count;
291 } XmPushButtonCallbackStruct;
292 reason Indicates why the callback was invoked.
294 event Points to the XEvent that triggered the callback.
296 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 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 <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 <Btn1Down>:
315 This action arms the PushButtonGadget.
316 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 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 <Btn1>(2+):
331 If XmNmultiClick is XmMULTICLICK_DISCARD, this action does
332 nothing.
333 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 <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 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 <Btn1Up>(2+):
356 If XmNmultiClick is XmMULTICLICK_DISCARD, this action does
357 nothing.
358 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 <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 <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 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 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 <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 <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 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 <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 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 <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 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 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 XmPushButtonGadget(library call)