An entryfield with a spinner for entering numeric or date values 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 and events of interest in the ColumnSpinBox class. (No methods are associated with this class.)

Property

Default

Description

baseClassName

COLUMNSPINBOX

Identifies the object as an instance of the ColumnSpinBox class

className

(COLUMNSPINBOX)

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 ColumnSpinBox object when the object has focus

colorNormal

WindowText
/Window

The color of the text in the ColumnSpinBox object when the object does not have focus

function

 

A text formatting function

picture

 

Formatting template

rangeMax

 

The maximum value

rangeMin

 

The minimum value

rangeRequired

false

Whether the range values are enforced even when no change has been made

step

1

The value added or subtracted when using the spinner

validErrorMsg

Invalid input

The message that is displayed when the valid event fails

value

 

The value currently displayed in the ColumnSpinBox object

 

Event

Parameters

Description

valid

 

When attempting to remove focus. Must return true, or focus remains.

 

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

Property

 

Event

 

Method

borderStyle
fontBold

fontItalic

fontName

fontSize

fontStrikeout

fontUnderline

 

hWnd
parent

speedTip

statusMessage

beforeCellPaint
onCellPaint

onGotFocus

onLeftDblClick
onLeftMouseDown
onLeftMouseUp
onLostFocus

onMiddleDblClick

onMiddleMouseDown

onMiddleMouseUp

onMouseMove

onRightDblClick

onRightMouseDown

onRightMouseUp

none

Description

A ColumnSpinBox is a simplified SpinBox control in a grid column. When the enumerated editorType property of a GridColumn control is set to SpinBox, the column uses a ColumnSpinBox control, which is accessible through the GridColumn object’s editorControl property.

Only the cell that has focus appears as a spinbox. All other cells in the column which do not have focus appear as ColumnEntryfield controls instead, with no spinner 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.