DojoComboBox widget

A Rich UI combo widget defines a combo box, which presents one of several selectable options and lets the user temporarily open a dropdown list to select a different option. This widget is based on the Dojo dijit.form.ComboBox definition.

Fields

editable
A boolean that indicates whether the user can change the text in the current selection. The changed text becomes the current selection but neither adds to the preset list of values nor changes a listed value permanently. The default is true.
pageSize
The number of values that are displayed in the dropdown list.
value
The current selection, which is visible. You can get and set this value, which is processed as a string and, in keeping with EGL conversion rules, can be a number.

When the Dojo combo box is the view component of a controller, the value that the view receives from the model component of the controller can take precedence over the value that you assign to the value property of the combo box. For details on controllers, see “Rich UI validation and formatting.”

values
An array of strings. The content is the list of all values that are available to the user.

If you assign to the value property a value that is not in the array, the assigned value will be visible; but if the user selects a value from the dropdown list, the assigned value is no longer available.

Other supported fields and functions are described in the following topics in the EGL Programmer’s Guide: “Rich UI widget fields” and ”Rich UI widget functions.”

Use of this widget requires the following statement:
import dojo.widgets.DojoComboBox;