# Selection Box widget

The Selection Box is a composite widget based on the Bulletin Board; it provides a means of retrieving an item of input from the user, either by selecting from a list of items, or by entering the item name directly.

If an item is selected from the list, it will be displayed in the Selection Box text edit window automatically.

No action is taken until the 'OK' button is pressed.

The Selection Box contains an Apply button, which is created unmanaged if the Selection Box is not a child of a dialogShell. It may be managed as needed (using the Managed toggle in the Core Resources Panel).

FileSelectionBox, Command and SelectionPrompt are related objects which share a common source.

For more information, consult XmSelectionBox(3X) in the OSF/Motif Programmer's Reference Manual.

NOTES

In Motif 1.1, you could add one Work Area child widget to a Selection Box in order to provide some extra functionality. In Motif 1.2, you can also add a Menu Bar widget and multiple PushButton children.

The built-in buttons in a Selection Box are gadgets and so will not highlight when selected.

HINTS

If you want to change the labels of the buttons in the Selection Box, they should be changed in the Selection Box resource panel (Labels page), not in the resource panel for each button.

You cannot get the value of the command string by applying XmTextGetString(3X) to the command entry text widget within any registered Command Entered and Command Changed callbacks. You can, however, get this information from the callback specific data passed to these functions.

See also:

- Selection Box resource panel
- Bulletin Board widget
- Code Preludes
- Module Preludes
- Form widget
- Row Column widget
- About WorkShop Visual