Height

Description

The height of the Spin List control specified as either the number of values show above and below the current choice or an explicit value specified in CSS units (e.g. 30px).

Discussion

Specify the control height. You can enter a number (e.g. 1, 2, 3) or a dimension (e.g. 30px). If you enter a number, this indicates the number of values to show above and below the selected value. If you enter a dimension, this indicates the total height of the control. The default Height is "1"

Example: Height of "2"

The Spin List shown below has a height of 2, meaning two values will be shown above and below the selected value:

images/slh2.png

Example: Height of "135px"

The Spin List shown below has a height of 135px:

images/slh135px.png

Example: Changing the Height Dynamically at Run-time

You can change the height programmatically at run-time. For example:

var s = {dialog.object}.getControl('spin1');
s.height = 2; //set height to 2 entries above and below
s.refresh();

s.height = '100px'; //set height to 100px
s.refresh(); // refresh the Spin List control
You must call the .refresh() method after changing the height property of a Spin List control.