SPINEDIT item type
Defines a spin box widget to enter integer values.
SPINEDIT item basics
The SPINEDIT
form item defines a field dedicated to numeric values. Depending on
the front-end platform, the widget may provide buttons to increment/decrement the field value.
Use a SMALLINT
or INTEGER
variable with a
SPINEDIT
form item. Larger types like BIGINT
or
DECIMAL
are not supported.
Defining a SPINEDIT
STEP
attribute:SPINEDIT ...
STEP = 5;
The VALUEMIN
and VALUEMAX
attributes define
respectively the lower and upper integer limit of the spin-edit range. There is no default minimum
or maximum value for the SPINEDIT
widget.
CONSTRUCT
, as you can only enter an integer
value.Front-ends support different presentation and behavior options, which can be controlled by a
STYLE
attribute. For more
details, see Style attributes common to all elements.
Detecting SPINEDIT modification
To inform the dialog when a value changes, define an ON CHANGE
block
for the SPINEDIT
field. The program can then react immediately to user changes in
the field:
-- Form file (grid layout)
SPINEDIT s1 = options.opts_rate,
VALUEMIN=0, VALUEMAX=100, STEP=5;
-- Program file:
ON CHANGE opts_rate
-- The value of the spinedit has changed
For more details, see Reacting to field value changes.
Where to use a SPINEDIT
SPINEDIT
form item can be defined in different ways:- With an item tag and a SPINEDIT item definition in a
grid-layout container (
GRID
,SCROLLGRID
andTABLE
). - As a SPINEDIT stack item in a
STACK
container.