HEIGHT-CHARS attribute

The height, in character units, of the widget. The HEIGHT-CHARS attribute of the SESSION handle contains the height of the display.

Data type:

DECIMAL

Access:

Readable/Writeable

Applies to:

BROWSE widget (browse and cell), BUTTON widget, COMBO-BOX widget, CONTROL-FRAME widget, DIALOG-BOX widget, EDITOR widget, FIELD-GROUP widget, FILL-IN widget, FRAME widget, IMAGE widget, LITERAL widget, RADIO-SET widget, RECTANGLE widget, SELECTION-LIST widget, SESSION system handle, SLIDER widget, TEXT widget, TOGGLE-BOX widget, WINDOW widget

For combo boxes, field groups, and the SESSION handle, this attribute is read-only.

In character mode, the HEIGHT-CHARS attribute must be set before the browse is realized. Attempting to set the attribute after realization of the browse causes a run-time error.

For control-frames, the HEIGHT-CHARS attribute maps to the Height property of the control-frame COM object (ActiveX control container).

For browses, the HEIGHT-CHARS attribute sets the decimal height, in characters, of the browse without changing the height of the browse’s rows. If you change the value of a browse’s HEIGHT-CHARS or HEIGHT-PIXELS attribute, the number of rows that appear in the viewport might change.