Combo Box (DriveWorks Documentation)

Combo Box

The Combo Box displays a drop down that contains items from which a selection can be made.

When the Form Control is applied the name entered will display as the caption for the Form Control. This can be changed by selecting the Caption property.

When an item in the Combo Box is selected the Form Control reports the exact item as it appears in the Control.

Items are added to the Control from the Items property. Use the pipebar (|) to separate each item, for example:

Examples
"Item A\|Item B\|Item C"
"1\|2\|3\|4"

Examples

"Item A|Item B|Item C"

"1|2|3|4"

Finding An Item By Matching Characters

It is possible to find an item in the list by beginning to type characters of the item you wish to find. The list will then jump to the section of the list to match the characters you have typed.

To do this simply start typing the characters of the item you want to find at a steady constant speed.

Properties

Appearance

Background Color
Specifies the color of the control's background.
Input Background Color
Specifies the background color of the control's input area.
Input Background Color (Disabled)
Specifies the background color of the control's input area when the control is disabled.
Input Background Color (Hover)
Specifies the background color of the control's input area when in a hovered state.
Input Icon Color
Specifies the color of the icon in the input.
Input Icon Color (Disabled)
Specifies the color of the icon in the input when the control is disabled.
Input Icon Color (Hover)
Specifies the color of the icon in the input when in a hovered state.
Input Opacity (Disabled)
Specifies the opacity of the control's input area when the control is disabled, between 0 and 100.
Input Padding
Specifies the padding of the control's input area.

Appearance - Border

Input Border Color
Specifies the border color of the control's input area.
Input Border Color (Disabled)
Specifies the border color of the control's input area when the control is disabled.
Input Border Color (Focus)
Specifies the border color of the control's input area when in a focused state.
Input Border Color (Hover)
Specifies the border color of the control's input area when in a hovered state.
Input Border Radius
Specifies the border radius of the control's input area.
Input Border Width
Specifies the border width of the control's input area.
Input Outline Color (Focus)
Specifies the outline color of the control's input area when in a focused state.

Appearance - Caption

Caption
Controls the control's caption.
Caption Color
Controls the caption color of the control.
Caption Font
Determines the font used for the controls caption.
Caption Horizontal Alignment
Controls whether the text inside the caption is horizontally aligned to the left, right or center

Appearance - Text

List Item Color
Controls the color of list items.
List Item Color (Disabled)
Controls the color of list items when the control is disabled.
List Item Color (Hover)
Controls the color of list items when in a hovered state.
List Item Font
Controls the font of list items.

Behavior

Clear Selection Allowed
If TRUE, allows the user to clear the active selection, otherwise if FALSE, an item IS always selected.
Default Value
Controls the default value of the control. If the default value is based on a rule and the value changes, then the value of the control will be changed to be the new default value.
Enabled
Controls whether the control is enabled (if the result is TRUE) or disabled (if the result is anything other than TRUE, e.g. FALSE).
Error Result
Determines whether the value of the control is in error. The result of this rule is a string containing the error message if the value is in error, otherwise a blank string or the number zero.
Items
Combo Box - A list of items, delimited by the | symbol, which control the items shown in the control.
Selected Item
The selected item in the list.
Selected Item (Override Rule)
The selected item in the list.
Selected Item Removed Behavior
Specifies the action taken by the list control when the list of items is changed, and the selected item is not in the new list.
Tab Index
Configures the position of the control in the form tab order.
Visible
Determines whether the control is visible (TRUE) or hidden (FALSE).

Events

Macro Argument
Provides an optional argument to the macro
On Change
Determines the name of the macro to fire when the value of this control changes.

General

(Metadata)
Optional text which can be used to provide information belonging to or about a control. For example, a list of CSS classes which can be parsed and applied to the control using the Integration Theme in DriveWorks Live. This doesn't affect the control's behavior.
(Name)
The name of the control
(Tag)
Optional text which can be used to describe the control, but which doesn't affect the control's behavior.
Tooltip Duration
Controls the duration, in seconds, for which the tooltip will remain visible. Values of 0 and below indicate an infinite duration.
Tooltip Text
Specifies the text to display in a tooltip when hovering over the control.

Layout

Caption Width
Controls the width of the control's caption.
Height
Controls the height of the control.
Left
Controls the left position of the control.
Top
Controls the top position of the control.
Width
Controls the width of the control.

DriveWorks Pro 22 Combo Box