Progress
Programming
Handbook
Defining a Combo Box
The following form of the VIEW–AS phrase defines a combo box:
When viewing a value as a combo box, only the fill-in field displaying the value appears in a box along with a button to indicate that it is combo box. The drop-down list appears only when you choose the fill-in or button in the box. The definition options have these effects:
- The LIST–ITEMS option specifies a comma-separated list of values for the drop-down list. The representation for each value must conform to the data type and format of the underlying field or variable. In Windows, there is no default selected value for the combo box; the fill-in is empty. The combo box fill–in remains empty until you assign an item in the list to the screen value of the widget.
- The LIST–ITEM–PAIRS option specifies a list of label-value pairs. Each pair represents the label and value of a field or variable. When the drop-down list appears, it displays each pair’s label. When the user selects a label, Progress assigns the corresponding value to the field or variable.
- The INNER–LINES option specifies the number of lines (items) displayed in the drop-down list at one time.
- In Windows, the size-phrase option specifies the outside width of the combo box. This includes the drop-down list width. The fill-in height is always the height of one character unit for a fill-in. This option also has no effect on the drop-down list height or the format of data in the list.
- The SORT option causes items in the drop-down list (LIST–ITEMS) to be displayed in sorted order no matter what order they are assigned. This option is supported in character interfaces only, and only in Windows.
- The TOOLTIP option allows you to define a help text message for a text field or text variable. Progress automatically displays this text when the user pauses the mouse button over a text field or text variable for which a tooltip is defined. No tooltip is the default. This option is supported in Windows only.
- The SIMPLE option specifies a combo–box widget with a read/write edit control and a selection list that is always visible. This option is supported in graphical interfaces only, and only in Windows.
- The DROP–DOWN option specifies a combo–box widget with a read/write edit control and a selection list that appears when you click the drop-down button. This option is supported in graphical interfaces only, and only in Windows.
- The DROP–DOWN–LIST option specifies a combo–box widget with a read-only edit control and a selection list that appears when you click the drop-down button. This is the default.
- The MAX–CHARS option specifies the maximum number of characters the edit control can hold. Use MAX–CHARS with only SIMPLE and DROP–DOWN combo–boxes. It is ignored for DROP–DOWN–LIST combo–boxes. This option is supported in graphical interfaces only, and only in Windows.
- The AUTO–COMPLETION option specifies that the edit control automatically complete keyboard input to the combo–box, based on a potential match, by searching through the items in the drop-down list. This option is supported in graphical interfaces only, and only in Windows.
- The UNIQUE–MATCH option specifies that the edit control complete keyboard input to the combo–box, based on a unique match, by searching through the items in the drop-down list. This option is supported in graphical interfaces only, and only in Windows.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |