class ColumnComboBox

A combobox in a grid column.

Syntax

These controls are created by assigning the appropriate editorType to the GridColumn object.

Properties

The following tables list the properties of interest in the ColumnComboBox class. (No particular events or methods are associated with this class.)

Property	Default	Description
autoTrim	false	whether or not trailing spaces are trimmed from character strings loaded from the control's dataSource.
baseClassName	COLUMNCOMBOBOX	Identifies the object as an instance of the ColumnComboBox class
className	(COLUMNCOMBOBOX)	Identifies the object as an instance of a custom class. When no custom class exists, defaults to baseClassName
colorHighlight		The color of the text in the ColumnComboBox object when the object has focus
colorNormal	WindowText /Window	The color of the text in the ColumnComboBox object when the object does not have focus
dataSource		The option strings of the ColumnComboBox object
dropDownHeight		The number of options displayed in the drop-down list
dropDownWidth		The width of the drop-down list in the form’s current metric units
function		A text formatting function
picture		Formatting template
sorted	false	Whether the options are sorted
value		The value currently displayed in the ColumnComboBox object

The following table lists the common properties, events, and methods of the ColumnComboBox class:

Description

A ColumnComboBox is a simplified ComboBox control in a grid column. The combobox is always the DropDownList style. When the enumerated editorType property of a GridColumn control is set to ComboBox, the column uses a ColumnComboBox control, which is accessible through the GridColumn object’s editorControl property.

Only the cell that has focus appears as a combobox. All other cells in the column which do not have focus appear as ColumnEntryfield controls instead, with no drop-down control.

As with all column controls, the dataLink and width for the control is in the parent GridColumn object, not the control itself. The height is controlled by the cellHeight of the grid.

If a mouse event is implemented for this control it overrides the matching grid level event.