Sign in Join
FPDoc Onlineexperiment

TBitBtn.Spacing property

Member of TBitBtnpublishedIn unit Buttons

The space reserved between the bitmap and the caption on the button control.

Declaration

pascal
property Spacing:;

Description

Spacing is an Integer property with the number of pixels used to separate the Glyph (or image) displayed on the button and its Caption. The default value for the property is 4 pixels.

The number of pixels in Spacing is always displayed - even when the Caption is an empty string. To suppress drawing of the additional space, set the property to 0.

Changing the value for the property causes the widgetset instance to be updated when its handle has been allocated. AdjustSize is called to auto-size a visible control and its parent. At design-time, the Invalidate method is called to redraw the control.

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

Use Layout to specify the edge on the button control to which the glyph bitmap is aligned.

Use Margin to set the space reserved on the aligned edge prior to the glyph bitmap.

For the macOS Carbon widgetset, the Spacing property is not supported. Layout and alignment is determined by the native control for the platform.

This description is the one of Buttons.TCustomBitBtn.Spacing.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.