A database selector is a special kind of list gadget. It provides a mechanism for displaying the current database element along with its owner and members. You can also interact with a selector to change the current element.

A single-choice selector permits only one selected value at a time. A typical example is the AVEVA E3D™ Members List.

The DATABASE keyword is mandatory.

The owners and members keywords are optional. By default, a database selector displays the current element together with elements both above it and below it in the database hierarchy. If present, the owners keyword specifies that only elements above the current element are shown. If present the members keyword specifies that only elements below the current element are shown.

If auto is specified, the selector automatically refreshes its displayed contents whenever the current element of the database changes. If absent, the contents of a selector remain as they were when the gadget was initially displayed until the gadget is explicitly refreshed by your PML code. The auto keyword and the multiple keyword cannot be used together.

To set and get selected values for a selector use the select() and selection() methods, and the .val members, as done for lists. For example, to access the currently selected value of a single-selector gadget: