Volume 6A: Motif Programming Manual

<Xm/FileSB.h>:

XmCreateFileSelectionBox()

XmCreateFileSelectionDialog()

<Xm/Command.h>:

XmCreateCommand()

Each of these routines creates a dialog widget. In addition, the routines that end in Dialog automatically create a

DialogShell as the parent of the dialog widget. All of the convenience functions for creating dialogs use the standard

Motif creation routine format. For example, XmCreateMessageDialog() takes the following form:

Widget

XmCreateMessageDialog(parent, name, arglist, argcount)

Widget parent;

String *name;

ArgList arglist;

Cardinal argcount;

In this case, we are creating a common MessageDialog, which is a MessageBox with a DialogShell parent. The

parent parameter specifies the widget that acts as the owner or parent of the DialogShell. Note that the parent must

not be a gadget, since the parent must have a window associated with it. The dialog widget itself is a child of the

DialogShell. You are returned a handle to the newly created dialog widget, not the DialogShell parent. For the

routines that just create a dialog widget, the parent parameter is simply a manager widget that contains the dialog.

The arglist and argcount parameters for the convenience routines specify resources using the old−style

ArgList format, just like the rest of the Motif convenience routines. A varargs−style interface is not available for

creating dialogs. However, you can use the varargs−style interface for setting resources on a dialog after is has been

created by using XtVaSetValues().

6.3.3 Setting ...