xmSelectionBox

xmSelectionBox

A selection box is a composite widget designed to ease creation of interfaces that present the user with a list of items from which to choose. A selection box has a number of component children, which the application can manage or unmanage. This is often done to add or remove elements from a dialog. Managing and unmanaging are the only two operations you should perform on elements of a composite selection box widget.

With a selection box named sb, these are the automatically-derived child widgets:

    sb.Apply          sb.OK        sb.Cancel
    sb.Selection      sb.Help      sb.Separator
    sb.ItemsList      sb.Text      sb.Items

Table 4-54 lists the callbacks associated with xmSelectionBox.

xmSelectionBox Callbacks
Method Name Why
applyCallback The Apply button is released.
cancelCallback The Cancel button is released.
okCallback The OK button is released.
noMatchCallback Nothing matches the selected expression.

xmSelectionBox Callbacks
Method Name	Why
applyCallback	The Apply button is released.
cancelCallback	The Cancel button is released.
okCallback	The OK button is released.
noMatchCallback	Nothing matches the selected expression.

These callbacks support the %value and %length substitution, which are replaced by the string (or string length) that fired the callback. The selection box widget also inherits all the callbacks defined in xmList and xmText.