Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : HEIGHT-CHARS attribute

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.