Option and Combobox Gadgets

PML Customisation User Guide

Gadget Set : Option and Combobox Gadgets

The OPTION and COMBOBOX gadgets offer a single choice from a list of items. Clicking the down-arrow icon opens the drop-down list to allow a selection of a field from the choices. The currently selected field is highlighted.

The two gadget types are similar, the main differences being:

•

Option gadget's display text field cannot be edited.

•

Combobox gadget's display text field is editable, just like a TEXT gadget.

•

Combobox does not support the display of pixmaps.

The drop-down list is very similar to a Single Choice List Gadget and supports DTEXT, RTEXT, ZEROSELECT and NORESELECT properties. The same methods are used to manage the list's content. In just the same way it also allows UNSELECT and SELECT events.

When you press the option gadget, the entire set of items is shown as a drop-down list and you can then select a new item by clicking the option required.

There is always a selected value unless the option list is empty.

You can use the Add methods to add a single new entry to be appended to OPTION gadgets:

Add( !Dtext is STRING )

Add( !Dtext is STRING, !Rtext is STRING )

Where Dtext is the text to be displayed in the option list, and Rtext is the replacement text for the new field.

If Rtext is not specified, it will be set to the Dtext string by default.