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

NAME

6       XmMessageBox — The MessageBox widget class
7

SYNOPSIS

9       #include <Xm/MessageB.h>
10

DESCRIPTION

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       ┌─────────────────┬────────────────────┬───────────────────────────────┐
82Named Descendant Class              Identity                      
83       ├─────────────────┼────────────────────┼───────────────────────────────┤
84       ├─────────────────┼────────────────────┼───────────────────────────────┤
85       ├─────────────────┼────────────────────┼───────────────────────────────┤
86Cancel           XmPushButtonGadget │ Cancel button                 │
87       ├─────────────────┼────────────────────┼───────────────────────────────┤
88Help             XmPushButtonGadget │ Help button                   │
89       ├─────────────────┼────────────────────┼───────────────────────────────┤
90Message          XmLabelGadget      │ displayed message             │
91       ├─────────────────┼────────────────────┼───────────────────────────────┤
92OK               XmPushButtonGadget │ OK button                     │
93       ├─────────────────┼────────────────────┼───────────────────────────────┤
94Separator        XmSeparatorGadget  │ dividing line between message │
95       │                 │                    │ and buttons                   │
96       ├─────────────────┼────────────────────┼───────────────────────────────┤
97Symbol           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  │                       │        │
123Name                 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     │               │        │
272Name                 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        │                      │        │
321Name                    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      │         │        │
360Name              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                │                      │        │
371Name                          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)
Impressum