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

# THeaderSection.Width

Total width in pixels for the text and image on the header section.

## Declaration

Source position: comctrls.pp line 3996

`published property THeaderSection.Width : Integer read GetWidth write SetWidth;`

## Description

Width is an Integer property with the number of pixels allocated for the text and image on the header section. It does not indicate the actual width of the content - only the size allocated for its display.

The Width property always returns 0 (zero) when Visible is set to False.

Setting a new value for the property causes it to be range-limited to the values in MinWidth and MaxWidth. The item is updated in its collection when Width has been changed.

The value in the property may be automatically scaled for high DPI displays in the DoAutoAdjustLayout and ChangeScale methods for the header control.

Width is updated at design-time when the divider between adjacent header sections is dragged.

Use MinWidth and MaxWidth to specify the smallest and largest sizes allowed for the header section.

## See also

THeaderSection.MaxWidth |  | Maximum width in pixels allowed for the header section.
THeaderSection.MinWidth |  | Minimum width in pixels allowed for the header section.
THeaderSection.Text |  | The text displayed on the header section.
THeaderSection.ImageIndex |  | Ordinal position for the image displayed for the header section.
TCustomHeaderControl.PaintSection |  | Paints the specified header section to the Canvas for the control.
TCustomHeaderControl.Sections |  | Sections - the short segments of the header separated by vertical bars that function as the elementary selection units of the header.
TCustomHeaderControl.ChangeScale |  | Scales the width of the header sections in the control using the specified multiplier and divisor.
TCustomHeaderControl.DoAutoAdjustLayout |  | Applies an automatic layout policy to the control using the specified scaling factors.