Volume 6A: Motif Programming Manual

In order to support the idea that the dialog is a single widget, the toolkit also provides a number of convenience

routines that you can use to modify the Command widget. The function XmCommandSetValue() sets the text in

the command entry area of the dialog. The function takes the following form:

void

XmCommandSetValue(widget, command)

Widget widget;

XmString command;

The command is displayed in the command entry area. The Command widget resource XmNcommand specifies the

text for the command entry area, so you can also set this resource directly. Alternatively, you can use

XmTextSetString() on the Text widget in the dialog to set the command. However, note that the string you

specify to this function is a regular character string, not a compound string.

If you want to append some text to the string in the command entry area, you can use the routine

XmCommandAppendValue(), which takes the following form:

void

XmCommandAppendValue(widget, command)

Widget widget;

XmString command;

The command is added to the end of the string in the command entry area. The function XmCommandError()

displays an error message in the history area of the Command widget. The function takes the following form:

void

XmCommandError(widget, message)

Widget widget;

XmString message;

The error message is displayed until the user enters the next command.

7.5 FileSelectionDialogs

Like the Command widget, the FileSelectionBox is subclassed from SelectionBox. The FileSelectionDialog looks

somewhat different than the other ...