1XmMessageBox(library call) XmMessageBox(library call)
2
3
4
6 XmMessageBox — The MessageBox widget class
7
9 #include <Xm/MessageB.h>
10
12 MessageBox is a dialog class used for creating simple message dialogs.
13 Convenience dialogs based on MessageBox are provided for several common
14 interaction tasks, which include giving information, asking questions,
15 and reporting errors.
16
17 A MessageBox dialog is typically transient in nature, displayed for the
18 duration of a single interaction. MessageBox is a subclass of Bullet‐
19 inBoard and depends on it for much of its general dialog behavior.
20
21 The default value for XmNinitialFocus is the value of XmNdefaultButton.
22
23 A typical MessageBox contains a message symbol, a message, and up to
24 three standard default PushButtons: OK, Cancel, and Help. It is laid
25 out with the symbol and message on top and the PushButtons on the bot‐
26 tom. The Help button is positioned to the side of the other push but‐
27 tons. You can localize the default symbols and button labels for Mes‐
28 sageBox convenience dialogs.
29
30 The user can specify resources in a resource file for the gadgets cre‐
31 ated automatically that contain the MessageBox symbol pixmap and sepa‐
32 rator. The gadget names are Symbol and Separator.
33
34 A MessageBox can also be customized by creating and managing new chil‐
35 dren that are added to the MessageBox children created automatically by
36 the convenience dialogs. In the case of TemplateDialog, only the sepa‐
37 rator child is created by default. If the callback, string, or pixmap
38 symbol resources are specified, the appropriate child will be created.
39
40 Additional children are laid out in the following manner:
41
42 · The first MenuBar child is placed at the top of the window. The
43 XmQTmenuSystem trait is used to check that it is the first
44 MenuBar child.
45
46 · All widgets or gadgets are placed after the OK button in the
47 order of their creation (this order is checked using the XmQTac‐
48 tivatable trait).
49
50 · A child that is not in the above categories is placed above the
51 row of buttons. If a message label exists, the child is placed
52 below the label. If a message pixmap exists, but a message label
53 is absent, the child is placed on the same row as the pixmap. The
54 child behaves as a work area and grows or shrinks to fill the
55 space above the row of buttons. The layout of multiple work area
56 children is undefined.
57
58 At initialization, MessageBox looks for the following bitmap files:
59
60 · xm_error
61
62 · xm_information
63
64 · xm_question
65
66 · xm_working
67
68 · xm_warning
69
70 See XmGetPixmap(3) for a list of the paths that are searched for these
71 files.
72
73 MessageBox uses the XmQTactivatable and XmQTmenuSystem traits.
74
75 Descendants
76 MessageBox automatically creates the descendants shown in the following
77 table. An application can use XtNameToWidget to gain access to the
78 named descendant. In addition, a user or an application can use the
79 named descendant when specifying resource values.
80
81 ┌─────────────────┬────────────────────┬───────────────────────────────┐
82 │Named Descendant │ Class │ Identity │
83 ├─────────────────┼────────────────────┼───────────────────────────────┤
84 ├─────────────────┼────────────────────┼───────────────────────────────┤
85 ├─────────────────┼────────────────────┼───────────────────────────────┤
86 │Cancel │ XmPushButtonGadget │ Cancel button │
87 ├─────────────────┼────────────────────┼───────────────────────────────┤
88 │Help │ XmPushButtonGadget │ Help button │
89 ├─────────────────┼────────────────────┼───────────────────────────────┤
90 │Message │ XmLabelGadget │ displayed message │
91 ├─────────────────┼────────────────────┼───────────────────────────────┤
92 │OK │ XmPushButtonGadget │ OK button │
93 ├─────────────────┼────────────────────┼───────────────────────────────┤
94 │Separator │ XmSeparatorGadget │ dividing line between message │
95 │ │ │ and buttons │
96 ├─────────────────┼────────────────────┼───────────────────────────────┤
97 │Symbol │ XmLabelGadget │ icon symbolizing message type │
98 ├─────────────────┼────────────────────┼───────────────────────────────┤
99 └─────────────────┴────────────────────┴───────────────────────────────┘
100 Classes
101 MessageBox inherits behavior, resources, and traits from Core, Compos‐
102 ite, Constraint, XmManager, and XmBulletinBoard.
103
104 The class pointer is xmMessageBoxWidgetClass.
105
106 The class name is XmMessageBox.
107
108 New Resources
109 The following table defines a set of widget resources used by the pro‐
110 grammer to specify data. The programmer can also set the resource val‐
111 ues for the inherited classes to set attributes for this widget. To
112 reference a resource by name or by class in a .Xdefaults file, remove
113 the XmN or XmC prefix and use the remaining letters. To specify one of
114 the defined values for a resource in a .Xdefaults file, remove the Xm
115 prefix and use the remaining letters (in either lowercase or uppercase,
116 but include any underscores between words). The codes in the access
117 column indicate if the given resource can be set at creation time (C),
118 set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
119 not applicable (N/A).
120
121 ┌──────────────────────────────────────────────────────────────────────────────────────────────┐
122 │ │ XmMessageB│ox Resource Set │ │ │
123 │Name │ Class │ Type │ Default │ Access │
124 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
125 │XmNcancelCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
126 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
127 │XmNcancelLabelString │ XmCCancelLabelString │ XmString │ dynamic │ CSG │
128 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
129 │XmNdefaultButtonType │ XmCDefaultButtonType │ unsigned char │ XmDIALOG_OK_BUTTON │ CSG │
130 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
131 │XmNdialogType │ XmCDialogType │ unsigned char │ XmDIALOG_MESSAGE │ CSG │
132 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
133 │XmNhelpLabelString │ XmCHelpLabelString │ XmString │ dynamic │ CSG │
134 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
135 │XmNmessageAlignment │ XmCAlignment │ unsigned char │ XmALIGNMENT_BEGINNING │ CSG │
136 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
137 │XmNmessageString │ XmCMessageString │ XmString │ "" │ CSG │
138 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
139 │XmNminimizeButtons │ XmCMinimizeButtons │ Boolean │ False │ CSG │
140 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
141 │XmNokCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
142 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
143 │XmNokLabelString │ XmCOkLabelString │ XmString │ dynamic │ CSG │
144 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
145 │XmNsymbolPixmap │ XmCPixmap │ Pixmap │ dynamic │ CSG │
146 ├─────────────────────┼──────────────────────┼────────────────┼───────────────────────┼────────┤
147 └─────────────────────┴──────────────────────┴────────────────┴───────────────────────┴────────┘
148 XmNcancelCallback
149 Specifies the list of callbacks that is called when the user
150 clicks on the cancel button. The reason sent by the callback
151 is XmCR_CANCEL.
152
153 XmNcancelLabelString
154 Specifies the string label for the cancel button. The
155 default for this resource depends on the locale. In the C
156 locale the default is Cancel.
157
158 Now that some default localized label strings are provided
159 through message catalogs for the children of composite wid‐
160 gets, the labelString resources cannot be set on the child
161 through default resource files. Instead, the resource pro‐
162 vided at the parent level must be used.
163
164 XmNdefaultButtonType
165 Specifies the default PushButton. A value of XmDIALOG_NONE
166 means that there should be no default PushButton. The fol‐
167 lowing types are valid:
168
169 · XmDIALOG_CANCEL_BUTTON
170
171 · XmDIALOG_OK_BUTTON
172
173 · XmDIALOG_HELP_BUTTON
174
175 · XmDIALOG_NONE
176
177 XmNdialogType
178 Specifies the type of MessageBox dialog, which determines the
179 default message symbol. The following are the possible val‐
180 ues for this resource:
181
182 XmDIALOG_ERROR
183 Indicates an ErrorDialog.
184
185 XmDIALOG_INFORMATION
186 Indicates an InformationDialog.
187
188 XmDIALOG_MESSAGE
189 Indicates a MessageDialog. This is the default
190 MessageBox dialog type. It does not have an asso‐
191 ciated message symbol.
192
193 XmDIALOG_QUESTION
194 Indicates a QuestionDialog.
195
196 XmDIALOG_TEMPLATE
197 Indicates a TemplateDialog. The TemplateDialog
198 contains only a separator child. It does not have
199 an associated message symbol.
200
201 XmDIALOG_WARNING
202 Indicates a WarningDialog.
203
204 XmDIALOG_WORKING
205 Indicates a WorkingDialog.
206
207 If this resource is changed with XtSetValues, the symbol bit‐
208 map is modified to the new XmNdialogType bitmap unless XmN‐
209 symbolPixmap is also being set in the call to XtSetValues.
210 If the dialog type does not have an associated message sym‐
211 bol, then no bitmap will be displayed.
212
213 XmNhelpLabelString
214 Specifies the string label for the help button. The default
215 for this resource depends on the locale. In the C locale the
216 default is Help.
217
218 Now that some default localized label strings are provided
219 through message catalogs for the children of composite wid‐
220 gets, the labelString resources cannot be set on the child
221 through default resource files. Instead, the resource pro‐
222 vided at the parent level must be used.
223
224 XmNmessageAlignment
225 Controls the alignment of the message Label. Possible values
226 include the following:
227
228 · XmALIGNMENT_BEGINNING (default)
229
230 · XmALIGNMENT_CENTER
231
232 · XmALIGNMENT_END
233
234 See the description of XmNalignment in the XmLabel reference
235 page for an explanation of these values.
236
237 XmNmessageString
238 Specifies the string to be used as the message.
239
240 XmNminimizeButtons
241 Sets the buttons to the width of the widest button and height
242 of the tallest button if False. If this resource is True,
243 button width and height are set to the preferred size of each
244 button.
245
246 XmNokCallback
247 Specifies the list of callbacks that is called when the user
248 clicks on the OK button. The reason sent by the callback is
249 XmCR_OK.
250
251 XmNokLabelString
252 Specifies the string label for the OK button. The default
253 for this resource depends on the locale. In the C locale the
254 default is OK.
255
256 Now that some default localized label strings are provided
257 through message catalogs for the children of composite wid‐
258 gets, the labelString resources cannot be set on the child
259 through default resource files. Instead, the resource pro‐
260 vided at the parent level must be used.
261
262 XmNsymbolPixmap
263 Specifies the pixmap label to be used as the message symbol.
264
265 Inherited Resources
266 MessageBox inherits behavior and resources from the superclasses
267 described in the following tables. For a complete description of each
268 resource, refer to the reference page for that superclass.
269
270 ┌──────────────────────────────────────────────────────────────────────────────────────┐
271 │ │ XmBulletinBoard │Resource Set │ │ │
272 │Name │ Class │ Type │ Default │ Access │
273 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
274 │XmNallowOverlap │ XmCAllowOverlap │ Boolean │ True │ CSG │
275 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
276 │XmNautoUnmanage │ XmCAutoUnmanage │ Boolean │ True │ CG │
277 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
278 │XmNbuttonFontList │ XmCButtonFontList │ XmFontList │ dynamic │ CSG │
279 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
280 │XmNbuttonRenderTable │ XmCButtonRenderTable │ XmRenderTable │ dynamic │ CSG │
281 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
282 │XmNcancelButton │ XmCWidget │ Widget │ Cancel button │ SG │
283 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
284 │XmNdefaultButton │ XmCWidget │ Widget │ dynamic │ SG │
285 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
286 │XmNdefaultPosition │ XmCDefaultPosition │ Boolean │ True │ CSG │
287 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
288 │XmNdialogStyle │ XmCDialogStyle │ unsigned char │ dynamic │ CSG │
289 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
290 │XmNdialogTitle │ XmCDialogTitle │ XmString │ NULL │ CSG │
291 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
292 │XmNfocusCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
293 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
294 │XmNlabelFontList │ XmCLabelFontList │ XmFontList │ dynamic │ CSG │
295 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
296 │XmNlabelRenderTable │ XmCLabelRenderTable │ XmRenderTable │ dynamic │ CSG │
297 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
298 │XmNmapCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
299 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
300 │XmNmarginHeight │ XmCMarginHeight │ Dimension │ 10 │ CSG │
301 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
302 │XmNmarginWidth │ XmCMarginWidth │ Dimension │ 10 │ CSG │
303 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
304 │XmNnoResize │ XmCNoResize │ Boolean │ False │ CSG │
305 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
306 │XmNresizePolicy │ XmCResizePolicy │ unsigned char │ XmRESIZE_ANY │ CSG │
307 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
308 │XmNshadowType │ XmCShadowType │ unsigned char │ XmSHADOW_OUT │ CSG │
309 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
310 │XmNtextFontList │ XmCTextFontList │ XmFontList │ dynamic │ CSG │
311 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
312 │XmNtextRenderTable │ XmCTextRenderTable │ XmRenderTable │ dynamic │ CSG │
313 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
314 │XmNtextTranslations │ XmCTranslations │ XtTranslations │ NULL │ C │
315 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
316 │XmNunmapCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
317 ├─────────────────────┼──────────────────────┼────────────────┼───────────────┼────────┤
318 └─────────────────────┴──────────────────────┴────────────────┴───────────────┴────────┘
319 ┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
320 │ │ XmManager │Resource Set │ │ │
321 │Name │ Class │ Type │ Default │ Access │
322 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
323 │XmNbottomShadowColor │ XmCBottomShadowColor │ Pixel │ dynamic │ CSG │
324 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
325 │XmNbottomShadowPixmap │ XmCBottomShadowPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
326 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
327 │XmNforeground │ XmCForeground │ Pixel │ dynamic │ CSG │
328 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
329 │XmNhelpCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
330 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
331 │XmNhighlightColor │ XmCHighlightColor │ Pixel │ dynamic │ CSG │
332 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
333 │XmNhighlightPixmap │ XmCHighlightPixmap │ Pixmap │ dynamic │ CSG │
334 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
335 │XmNinitialFocus │ XmCInitialFocus │ Widget │ dynamic │ CSG │
336 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
337 │XmNlayoutDirection │ XmCLayoutDirection │ XmDirection │ dynamic │ CG │
338 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
339 │XmNnavigationType │ XmCNavigationType │ XmNavigationType │ XmTAB_GROUP │ CSG │
340 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
341 │XmNpopupHandlerCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
342 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
343 │XmNshadowThickness │ XmCShadowThickness │ Dimension │ dynamic │ CSG │
344 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
345 │XmNstringDirection │ XmCStringDirection │ XmStringDirection │ dynamic │ CG │
346 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
347 │XmNtopShadowColor │ XmCTopShadowColor │ Pixel │ dynamic │ CSG │
348 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
349 │XmNtopShadowPixmap │ XmCTopShadowPixmap │ Pixmap │ dynamic │ CSG │
350 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
351 │XmNtraversalOn │ XmCTraversalOn │ Boolean │ True │ CSG │
352 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
353 │XmNunitType │ XmCUnitType │ unsigned char │ dynamic │ CSG │
354 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
355 │XmNuserData │ XmCUserData │ XtPointer │ NULL │ CSG │
356 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
357 └────────────────────────┴───────────────────────┴───────────────────┴──────────────────────┴────────┘
358 ┌───────────────────────────────────────────────────────────────────────┐
359 │ │ Composite Reso│urce Set │ │ │
360 │Name │ Class │ Type │ Default │ Access │
361 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
362 │XmNchildren │ XmCReadOnly │ WidgetList │ NULL │ G │
363 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
364 │XmNinsertPosition │ XmCInsertPosition │ XtOrderProc │ NULL │ CSG │
365 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
366 │XmNnumChildren │ XmCReadOnly │ Cardinal │ 0 │ G │
367 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
368 └──────────────────┴───────────────────┴─────────────┴─────────┴────────┘
369 ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
370 │ │ Core Resource Se│t │ │ │
371 │Name │ Class │ Type │ Default │ Access │
372 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
373 │XmNaccelerators │ XmCAccelerators │ XtAccelerators │ dynamic │ N/A │
374 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
375 │XmNancestorSensitive │ XmCSensitive │ Boolean │ dynamic │ G │
376 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
377 │XmNbackground │ XmCBackground │ Pixel │ dynamic │ CSG │
378 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
379 │XmNbackgroundPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
380 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
381 │XmNborderColor │ XmCBorderColor │ Pixel │ XtDefaultForeground │ CSG │
382 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
383 │XmNborderPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
384 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
385 │XmNborderWidth │ XmCBorderWidth │ Dimension │ 0 │ CSG │
386 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
387 │XmNcolormap │ XmCColormap │ Colormap │ dynamic │ CG │
388 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
389 │XmNdepth │ XmCDepth │ int │ dynamic │ CG │
390 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
391 │XmNdestroyCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
392 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
393 │XmNheight │ XmCHeight │ Dimension │ dynamic │ CSG │
394 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
395 │XmNinitialResourcesPersistent │ XmCInitialResourcesPersistent │ Boolean │ True │ C │
396 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
397 │XmNmappedWhenManaged │ XmCMappedWhenManaged │ Boolean │ True │ CSG │
398 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
399 │XmNscreen │ XmCScreen │ Screen * │ dynamic │ CG │
400 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
401 │XmNsensitive │ XmCSensitive │ Boolean │ True │ CSG │
402 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
403 │XmNtranslations │ XmCTranslations │ XtTranslations │ dynamic │ CSG │
404 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
405 │XmNwidth │ XmCWidth │ Dimension │ dynamic │ CSG │
406 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
407 │XmNx │ XmCPosition │ Position │ 0 │ CSG │
408 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
409 │XmNy │ XmCPosition │ Position │ 0 │ CSG │
410 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
411 └──────────────────────────────┴───────────────────────────────┴────────────────┴──────────────────────┴────────┘
412 Callback Information
413 A pointer to the following structure is passed to each callback:
414
415 typedef struct
416 {
417 int reason;
418 XEvent *event;
419 } XmAnyCallbackStruct;
420
421 reason Indicates why the callback was invoked
422
423 event Points to the XEvent that triggered the callback
424
425 Translations
426 XmMessageBox includes the translations from XmManager.
427
428 Additional Behavior
429 The XmMessageBox widget has the following additional behavior:
430
431 <Key><osfCancel>:
432 Calls the activate callbacks for the cancel button if it is
433 sensitive.
434
435 <Key><osfActivate>:
436 Calls the activate callbacks for the button with the keyboard
437 focus. If no button has the keyboard focus, calls the acti‐
438 vate callbacks for the default button if it is sensitive.
439
440 <Ok Button Activated>:
441 Calls the callbacks for XmNokCallback.
442
443 <Cancel Button Activated>:
444 Calls the callbacks for XmNcancelCallback.
445
446 <Help Button Activated>:
447 Calls the callbacks for XmNhelpCallback.
448
449 <FocusIn>:
450 Calls the callbacks for XmNfocusCallback.
451
452 <Map>: Calls the callbacks for XmNmapCallback if the parent is a
453 DialogShell.
454
455 <Unmap>: Calls the callbacks for XmNunmapCallback if the parent is a
456 DialogShell.
457
458 Virtual Bindings
459 The bindings for virtual keys are vendor specific. For information
460 about bindings for virtual buttons and keys, see VirtualBindings(3).
461
463 Composite(3), Constraint(3), Core(3), XmBulletinBoard(3), XmCreateEr‐
464 rorDialog(3), XmCreateInformationDialog(3), XmCreateMessageBox(3),
465 XmCreateMessageDialog(3), XmCreateQuestionDialog(3), XmCreateTemplate‐
466 Dialog(3), XmCreateWarningDialog(3), XmCreateWorkingDialog(3), XmMan‐
467 ager(3), XmMessageBoxGetChild(3), XmVaCreateMessageBox(3), and XmVaCre‐
468 ateManagedMessageBox(3).
469
470
471
472 XmMessageBox(library call)