[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Controls' (#lcl)

# TControlChildSizing.ControlsPerLine

The number of controls displayed per column or row for the orientation / fill direction specified in Layout.

## Declaration

Source position: controls.pp line 2001

`published property TControlChildSizing.ControlsPerLine : Integer read FControlsPerLine write SetControlsPerLine default 0;`

## Description

ControlsPerLine is an Integer property which indicates the number of child controls displayed in a column or row using the Layout for the Control. It is relevant when Layout is set to a value other than cclNone.

When Layout is set to cclLeftToRightThenTopToBottomm it indicates the child controls displayed per row. When Layout contains clTopToBottomThenLeftToRight, it indicates the child controls displayed per column. The default value is 0 (zero), and indicates that an explicit value has not been assigned to the property and causes the grid Layout to act as if 1 was specified in the property value.

Changing the value in ControlsPerLine causes the Change method to be called to resize the child controls on the parent Control and signal the OnChange event handler (when assigned).

ControlsPerLine is used in controls like TRadioGroup and TCheckGroup to arrange the radio buttons or check boxes on the control into columns and rows.

## See also

TControlChildSizing.Layout |  | Indicates the layout direction used when child controls are resized and arranged into rows and / or columns.
TControlChildSizing.Change |  | Notifies the Control of the child sizing changes and signals the OnChange event handler.
TControlChildSizing.OnChange |  | Event handler signalled when the size or layout for child controls has been changed.
TControlChildrenLayout |  | Defines the logic used to arrange child controls.