HEIGHT attribute

The HEIGHT attribute forces an explicit height for a form element.

Syntax

HEIGHT = integer [CHARACTERS|LINES|POINTS|PIXELS]
  1. value is an integer that defines the height of the element.

Usage

By default, the height of an element is defined by the size of the form item tag. Use the HEIGHT attribute, to define a specific height for a form item.

The HEIGHT attribute is only available for some types of resizable form items, such as TABLE, TREE, IMAGE, WEBCOMPONENT.

Note:

As a general rule, consider not specifying a unit, to default to relative characters/lines/columns, instead of specifying exact pixels or points. This is especially important for mobile devices, where the screen resolution can significantly vary depending on the smartphone or tablet model.

If you don't specify a size unit for the HEIGHT attribute, it defaults to CHARACTERS, which defines a height based on the characters size in the current font.

The CHARACTERS unit corresponds to the CSS "em" unit and specifies a height based on the font-size used by the form.

The PIXELS unit defines a number of CSS "px" pixels. In this context, the size of a pixel is defined by web standards and is independent of the screen resolution.

The POINTS unit specifies an absolute CSS "pt" size defined as follows: 72 points = 1 inch.

The LINES unit defines a number of grid lines for IMAGE fields. The size of a grid line depends on the font-size used by the elements in the form. For TABLE/TREE containers, the LINES units is interpreted as a number of rows.

For sizable items like IMAGE and WEBCOMPONENT, the default height is defined by the number of lines of the form item tag in the layout, as a vertical character height. Overwrite this default by specifying the HEIGHT attribute:

IMAGE img1: image1, WIDTH = 20, HEIGHT = 12;

For TABLE/TREE containers, the default height is defined by the number of lines used in the table layout. Overwrite the default by specifying the HEIGHT = x LINES attribute:

TABLE tab1: table1, HEIGHT = 25 LINES;

The size of an element like TABLE, WEBCOMPONENT or IMAGE has an impact on the size of a modal window where the form of the table is displayed. However, regular windows will be sized from the window container, and the form content will adapt to it.