Skip to main content
Version: 20 R7 BETA

LISTBOX SET ROWS HEIGHT

LISTBOX SET ROWS HEIGHT ( {* ;} object ; height {; unit} )

ParameterTypeDescription
*OperatorIf specified, object is an object name (string) If omitted, object is a variable
objectanyObject name (if * is specified) or Variable (if * is omitted)
heightIntegerRow height (in pixels)
unitIntegerUnit of height value:0 or omitted = pixels, 1 = lines

This command is not thread-safe, it cannot be used in preemptive code.

Description

The LISTBOX SET ROWS HEIGHT command allows you to modify by programming the row height in the list box object set using the object and * parameters.

If you pass the optional * parameter, you indicate that the object parameter is an object name (string). If you do not pass this parameter, you indicate that the object parameter is a variable. In this case, you pass a variable reference instead of a string. For more information about object names, refer to the Object Properties section.

By default, if you omit the unit parameter, the height is expressed in pixels. To modify the unit, in the unit parameter you can pass one of the following constants, found in the List Box theme:

ConstantTypeValueComment
lk linesInteger1Height is expressed as a number of lines. 4D calculates the height of a line according to the font.
lk pixelsInteger0Height is expressed as a number of pixels (default).

Note: For more information about calculating the height of rows, refer to the Design Reference manual.

See also

LISTBOX Get rows height
LISTBOX SET AUTO ROW HEIGHT
LISTBOX SET ROW HEIGHT