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 ...