Volume 6A: Motif Programming Manual

XmDIALOG_COMMAND

XmDIALOG_FILE_SELECTION

These values should be self−explanatory, with the exception of XmDIALOG_WORK_AREA. This value is set when a

SelectionBox is not the child of a DialogShell and it is not one of the other types of dialogs. In other words, if you

create a SelectionDialog using XmCreateSelectionDialog(), the value is XmDIALOG_SELECTION, but if

you use XmCreateSelectionBox(), the value is XmDIALOG_WORK_AREA. When a SelectionBox is created as

the child of a DialogShell, the Apply button is automatically managed, except if XmNdialogType is set to

XmDIALOG_PROMPT. Otherwise, the button is created but not managed.

The different types of SelectionDialogs are meant to be used for unique purposes. Each dialog provides different

components that the user can interact with to perform a task. In the following sections, we examine each of the

SelectionDialogs in turn.

7.2 SelectionDialogs

The SelectionDialog provides a ScrolledList that allows the user to select from a list of choices, as well as a TextField

where the user can type in choices. When the user makes a selection from the list, the selected item is displayed in the

text entry area. The user can also type new or existing choices into the text entry area directly. The dialog does not

take any action until the user activates one of the buttons in the action area or presses the RETURN key. If the user

double−clicks on an item in the List, the item is displayed in the text area and the OK button is automatically

activated. the ...