TcxButtonImageOptions.Layout Property

Specifies the active button content layout.

Declaration

property Layout: TButtonLayout read; write; default blGlyphLeft;

Property Value

Type	Default	Description
TButtonLayout	blGlyphLeft	The selected button layout.

Remarks

Use the Layout property to switch between four predefined layout options when the button displays both a glyph (assigned using Glyph or Images/ImageIndex) and caption.

Note

The Layout property has no effect in Command Link mode (if the TcxButton.Kind property is set to cxbkCommandLink).

Available Options

blGlyphLeft

The caption follows the glyph in a horizontal layout.

blGlyphRight

The glyph follows the caption in a horizontal layout.

blGlyphTop

The glyph is above the caption in a vertical layout.

blGlyphBottom

The glyph is below the caption in a vertical layout.

Additional Layout-Related Options

Use the Margin property to specify the distance between the displayed glyph and the nearest button border (depending on the current Layout property value).

In addition, you can use the Spacing property to adjust the distance between the glyph and the caption regardless of the current Layout property value.

Default Value

The Layout property’s default value is blGlyphLeft.