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

# TCustomBitBtn.Layout

Layout or alignment for the glyph bitmap and caption on the control.

## Declaration

Source position: buttons.pp line 226

`public property TCustomBitBtn.Layout : TButtonLayout read FLayout write SetLayout default blGlyphLeft;`

## Description

Layout is a TButtonLayout property which indicates the alignment used for the Glyph (or image) and the Caption on the button control. The default value for the property is blGlyphLeft. It causes the Margin, Glyph (or image), Spacing, and Caption to be aligned to the left edge of the button surface.

Changing the property value causes the widgetset class instance to be updated when its handle has been allocated. InvalidatePreferredSize is called to recalculate the preferred dimensions for the control. AdjustSize is called to auto-size a visible control and its parent.

The property value is used in the InitializeWnd method to set the initial value in the widget class instance.

Use Margin to set the space reserved prior to the glyph bitmap on the aligned edge of the control. Use Spacing to set the space reserved between the Glyph image and the Caption relative to the aligned edge of the control.

## See also

TCustomBitBtn.Caption |  | Contains the descriptive text displayed for the Bitmap button control.
TCustomBitBtn.Glyph |  | Bitmap with the Glyph displayed on the control.
TCustomBitBtn.Images |  | Contains the list of images available for use as the glyph on a custom button control.
TCustomBitBtn.ImageIndex |  | Ordinal position for the default bitmap displayed when the button control is up (not pressed).
TCustomBitBtn.Margin |  | The space prior to the glyph bitmap on the aligned edge of the button layout.
TCustomBitBtn.Spacing |  | The space reserved between the bitmap and the caption on the button control.
TButtonLayout |  | Enumerated type which defines the position for a glyph on a button.