paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-08-13 10:49:16 +02:00
Code Issues Packages Projects Releases Wiki Activity

Docs: LCL/controls. Updates content in TControlBorderSpacing topics.

Browse Source
This commit is contained in:
dsiders 2024-05-16 02:32:02 +01:00
parent 34f8d18775
commit 2eee207d67
1 changed files with 542 additions and 82 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

624
docs/xml/lcl/controls.xml
View File

@ -6044,9 +6044,9 @@ Used to differentiate default values in derived <var>TControl</var> classes.
<short>Describes the (minimum) spacing around a control.</short> <short>Describes the (minimum) spacing around a control.</short>
<descr> <descr>
<p> <p>
TControlBorderSpacing defines the spacing around a control. The spacing <var>TControlBorderSpacing</var> defines the number of pixels reserved as
around its children and between its children is defined in <link spacing on the various borders for a control. TControlBorderSpacing is the type
id="TWinControl.ChildSizing"/>. used to implement the <var>BorderSpacing</var> property in <var>TControl</var>.
</p> </p>
<dl> <dl>
<dt> <dt>
@ -6080,8 +6080,24 @@ CellAlignHorizontal, CellAlignVertical: TControlCellAlign;
Used, for example, when the Parent ChildSizing.Layout defines a table layout. Used, for example, when the Parent ChildSizing.Layout defines a table layout.
</dd> </dd>
</dl> </dl>
<p>
See <link id="TWinControl.ChildSizing"/> and <link id="TControlChildSizing"/>
for information about spacing around and between child controls on a control
instance.
</p>
</descr> </descr>
<seealso/> <seealso>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControlBorderSpacing.InnerBorder"/>
<link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.Right"/>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.CellAlignHorizontal"/>
<link id="TControlBorderSpacing.CellAlignVertical"/>
<link id="TControl.BorderSpacing"/>
<link id="TWinControl.ChildSizing"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.FAround"/> <element name="TControlBorderSpacing.FAround"/>
@ -6190,7 +6206,7 @@ Implements the storage specifier for the Around property.
<short> <short>
Returns <b>True</b> if border spacing value in Around has been assigned Returns <b>True</b> if border spacing value in Around has been assigned
and contains a non-zero value, or when the value is different than the and contains a non-zero value, or when the value is different than the
default value passes to the constructor. default value passed to the constructor.
</short> </short>
</element> </element>
@ -6484,6 +6500,7 @@ The space on a control side including Around space.
<short>Ordinal position for the value in the indexed property.</short> <short>Ordinal position for the value in the indexed property.</short>
</element> </element>
<!-- TODO: Review. This feels wrong for some reason. -->
<element name="TControlBorderSpacing.AutoAdjustLayout"> <element name="TControlBorderSpacing.AutoAdjustLayout">
<short> <short>
Automatically adjusts the size of the control using the specified proportions. Automatically adjusts the size of the control using the specified proportions.
@ -6535,7 +6552,9 @@ value(s) in <var>InnerBorder</var> have been altered.
</element> </element>
<element name="TControlBorderSpacing.Control"> <element name="TControlBorderSpacing.Control">
<short>The control to which this border spacing applies.</short> <short>
The control where the border spacing values are applied.
</short>
<descr/> <descr/>
<seealso/> <seealso/>
</element> </element>
@ -6547,19 +6566,35 @@ Provides indexed access to the border spacing value for a given anchor side.
<descr> <descr>
<p> <p>
<var>Space</var> is an indexed <var>Integer</var> property which provides <var>Space</var> is an indexed <var>Integer</var> property which provides
access to the border spacing used for a specified TAnchorKind value. For example: access to the border spacing used for a specified <var>TAnchorKind</var> value.
</p>
<p>
For example:
</p> </p>
<code>AControl.BorderSpacing.Space[akTop] := 6;</code> <code>AControl.BorderSpacing.Space[akTop] := 6;</code>
<p>
Which is equivalent to:
</p>
<code>AControl.BorderSpacing.Top := 6;</code>
</descr> </descr>
<seealso/> <seealso>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.Right"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControl.BorderSpacing"/>
<link id="TAnchorKind"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.Space.Kind"> <element name="TControlBorderSpacing.Space.Kind">
<short>The side with border spacing accessed in the property.</short> <short>
The side with border spacing accessed in the property.
</short>
</element> </element>
<element name="TControlBorderSpacing.AroundLeft"> <element name="TControlBorderSpacing.AroundLeft">
<short> <short>
Spacing reserved on the left-hand side of the control. Total border spacing reserved using the Around and Left properties.
</short> </short>
<descr> <descr>
<p> <p>
@ -6567,9 +6602,7 @@ Spacing reserved on the left-hand side of the control.
indicates the spacing used around and on the left-hand side of the control. indicates the spacing used around and on the left-hand side of the control.
</p> </p>
<p> <p>
AroundLeft represents the total space reserved on all sides of the control, AroundLeft is calculated as the sum of the values in the <var>Around</var>
plus any additional space reserved on it left-hand edge. The value for the
property is calculated as the sum of the values from the <var>Around</var>
and <var>Left</var> properties. Updates must be performed to the Around and and <var>Left</var> properties. Updates must be performed to the Around and
Left properties. Left properties.
</p> </p>
@ -6577,73 +6610,140 @@ Left properties.
<seealso> <seealso>
<link id="TControlBorderSpacing.Around"/> <link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Left"/> <link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.AroundRight"/>
</seealso> </seealso>
</element> </element>
<element name="TControlBorderSpacing.AroundTop"> <element name="TControlBorderSpacing.AroundTop">
<short> <short>
Space reserved on the top edge of the control. Total border spacing reserved using the Around and Top properties.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>AroundTop</var> is a read-only <var>Integer</var> property which
indicates the spacing used around and on the top side of the control.
</p>
<p>
AroundTop is calculated as the sum of the values in the <var>Around</var>
and <var>Top</var> properties. Updates must be performed to the Around and
Top properties.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.AroundBottom"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.AroundRight"> <element name="TControlBorderSpacing.AroundRight">
<short> <short>
Space reserved on the right-hand side of the control. Total border spacing reserved using the Around and Right properties.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>AroundRight</var> is a read-only <var>Integer</var> property which
indicates the spacing used around and on the right-hand edge of the control.
</p>
<p>
AroundRight is calculated as the sum of the values in the <var>Around</var>
and <var>Right</var> properties. Updates must be performed to the Around and
Right properties.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Right"/>
<link id="TControlBorderSpacing.AroundLeft"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.AroundBottom"> <element name="TControlBorderSpacing.AroundBottom">
<short> <short>
Space reserved on the bottom edge of the control. Total border spacing reserved using the Around and Bottom properties.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>AroundBottom</var> is a read-only <var>Integer</var> property which
indicates the spacing used around and on the bottom side of the control.
</p>
<p>
AroundBottom is calculated as the sum of the values in the <var>Around</var>
and <var>Bottom</var> properties. Updates must be performed to the Around and
Bottom properties.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControlBorderSpacing.AroundTop"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.ControlLeft"> <element name="TControlBorderSpacing.ControlLeft">
<short> <short>
Space reserved on the left-hand edge of the control relative to the position Position for the left-hand edge of the associated Control after it has been
for the control. adjusted for border spacing.
</short> </short>
<descr> <descr>
<p> <p>
<var>ControlLeft</var> is a read-only <var>Integer</var> property that <var>ControlLeft</var> is a read-only <var>Integer</var> property. Its value is
indicates the space reserved on the left-hand edge of the control relative to calculated as the difference between the <var>Left</var> property in the
the position for the control class instance. The value in <var>Control</var> and the values in the <var>Around</var> and <var>Left</var>
<var>ControlLeft</var> is calculated as the difference between the properties for the class instance.
<var>Left</var> position for the control and the values in the
<var>Around</var> and <var>Left</var> properties. For example:
</p> </p>
<code>FControl.Left-Around-Left</code> <p>
For example:
</p>
<code>Control.Left - Around - Left</code>
<p> <p>
If a <var>TControl</var> instance is not available in <var>Control</var>, the If a <var>TControl</var> instance is not available in <var>Control</var>, the
value for the property is <b>0</b> (<b>zero</b>). value for the property is <b>0</b> (<b>zero</b>).
</p> </p>
</descr> </descr>
<seealso> <seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/> <link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Left"/> <link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.ControlWidth"/>
<link id="TControl.Left"/> <link id="TControl.Left"/>
</seealso> </seealso>
</element> </element>
<element name="TControlBorderSpacing.ControlTop"> <element name="TControlBorderSpacing.ControlTop">
<short> <short>
Space reserved on the top edge of the control relative to the position for Position for the top edge of the associated Control after it has been
the control. adjusted for border spacing.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>ControlTop</var> is a read-only <var>Integer</var> property. Its value is
calculated as the difference between the <var>Top</var> property in the
<var>Control</var> and the values in the <var>Around</var> and <var>Top</var>
properties.
</p>
<p>
For example:
</p>
<code>Control.Top - Around - Top</code>
<p>
If a <var>TControl</var> instance is not available in <var>Control</var>, the
value for the property is <b>0</b> (<b>zero</b>).
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.ControlHeight"/>
<link id="TControl.Top"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.ControlWidth"> <element name="TControlBorderSpacing.ControlWidth">
<short> <short>
Total width for the control including spacing values in Around, Left, and Total width for the control including border spacing values in Around, Left,
Right. and Right.
</short> </short>
<descr> <descr>
<p> <p>
@ -6652,110 +6752,470 @@ contains the total width for the control including spacing values in the
<var>Around</var>, <var>Left</var>, and <var>Right</var> properties. The <var>Around</var>, <var>Left</var>, and <var>Right</var> properties. The
property value is calculated using the following formula: property value is calculated using the following formula:
</p> </p>
<code>TControl.Width + (2 * Around) + Left + Right</code> <code>Control.Width + (2 * Around) + Left + Right</code>
<p> <p>
If a <var>TControl</var> instance is not available in <var>Control</var>, the If a <var>TControl</var> instance is not available in <var>Control</var>, the
value for the property is <b>0</b> (<b>zero</b>). value for the property is <b>0</b> (<b>zero</b>).
</p> </p>
</descr> </descr>
<seealso/> <seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.Right"/>
<link id="TControlBorderSpacing.ControlHeight"/>
<link id="TControl.Width"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.ControlHeight"> <element name="TControlBorderSpacing.ControlHeight">
<short> <short>
Total height for the control including spacing values in Around, Top, and Total height for the control including border spacing values in Around, Top,
Bottom. and Bottom.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>ControlHeight</var> is a read-only <var>Integer</var> property with the
total height for the associated <var>Control</var> including border spacing
values. The property value is calculated using the following formula:
</p>
<code>Control.Height + (2 * Around) + Top + Bottom</code>
<p>
If a <var>TControl</var> instance is not available in <var>Control</var>, the
value for the property is <b>0</b> (<b>zero</b>).
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControlBorderSpacing.ControlWidth"/>
<link id="TControl.Height"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.ControlRight"> <element name="TControlBorderSpacing.ControlRight">
<short> <short>
Space reserved on the right-hand edge of the control relative to the position Position for the right-hand edge of the associated Control after it has been
for the control. adjusted for border spacing.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>ControlRight</var> is a read-only <var>Integer</var> property. Its value
is calculated as the sum of the <var>Left</var> property in the
<var>Control</var>, its <var>Width</var>, and the values in the
<var>Around</var> and <var>Right</var> properties for the class instance.
</p>
<p>
For example:
</p>
<code>Control.Left + Control.Width + Around + Right</code>
<p>
If a <var>TControl</var> instance is not available in <var>Control</var>, the
value for the property is <b>0</b> (<b>zero</b>).
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Right"/>
<link id="TControlBorderSpacing.ControlLeft"/>
<link id="TControl.Left"/>
<link id="TControl.Width"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.ControlBottom"> <element name="TControlBorderSpacing.ControlBottom">
<short> <short>
Space reserved on the bottom edge of the control relative to the position for Position for the bottom of the associated Control including assigned border
the control. spacing.
</short> </short>
<descr/> <descr>
<seealso/> <p>
<var>ControlBottom</var> is a read-only <var>Integer</var> property. Its value
is calculated as the sum of the <var>Top</var> property in the
<var>Control</var> and its <var>Height</var> with the values in the
<var>Around</var> and <var>Bottom</var> properties.
</p>
<p>
For example:
</p>
<code>Control.Top + Control.Height + Around + Bottom</code>
<p>
If a <var>TControl</var> instance is not available in <var>Control</var>, the
value for the property is <b>0</b> (<b>zero</b>).
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControlBorderSpacing.ControlWidth"/>
<link id="TControl.Top"/>
<link id="TControl.Height"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.OnChange"> <element name="TControlBorderSpacing.OnChange">
<short>Event handler for a change in border spacing.</short> <short>
<descr/> Event handler signalled when border spacing value(s) have been changed.
<seealso/> </short>
<descr>
<p>
<var>OnChange</var> is a <var>TNotifyEvent</var> property with the event
handler signalled when one of the properties in the class instance has been
changed. OnChange is signalled (when assigned) from the Change method. It
occurs after the border spacing values have been applied to the associated
Control, and its size has been adjusted.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.Control"/>
<link id="TControl.DoBorderSpacingChange"/>
<link id="#rtl.classes.TNotifyEvent">TNotifyEvent</link>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.Left"> <element name="TControlBorderSpacing.Left">
<short>The space at the left border.</short> <short>
<descr/> The border space on the left edge of the associated control.
<seealso/> </short>
<descr>
<p>
<var>Left</var> is a <var>TSpacingSize</var> property which indicates the
number of pixels used as border spacing for the associated <var>Control</var>.
It specifies the minimum distance between either the left edge of the parent
control or the right edge of an adjacent sibling control.
</p>
<p>
Changing the value for the property causes the <var>Change</var> method to be
called to notify and apply modifications to the associated Control, and to
signal the <var>OnChange</var> event handler (when assigned).
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder may be scaled by X
and Y scaling factors when the AutoAdjustLayout method is called.
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder are used in Control
methods which anchor or adjust the layout and size for the control instance on
its parent control.
</p>
<p>
Use Right to specify the border spacing on the right-hand edge of the
associated Control.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.AutoAdjustLayout"/>
<link id="TWinControl.AlignControls"/>
<link id="TWinControl.Controls"/>
<link id="TWinControl.CalculatePreferredSize"/>
<link id="TControl.Parent"/>
<link id="TControl.DoAutoAdjustLayout"/>
<link id="TControl.AnchorToNeighbour"/>
<link id="TControl.AnchorAsAlign"/>
<link id="TSpacingSize"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.Top"> <element name="TControlBorderSpacing.Top">
<short>The space at the top border.</short> <short>
<descr/> The border space on the top edge of the associated control.
<seealso/> </short>
<descr>
<p>
<var>Top</var> is a <var>TSpacingSize</var> property which indicates the number
of pixels used as border spacing for the associated <var>Control</var>. It
specifies the minimum distance between either the top edge of the parent
control or the bottom edge of an adjacent sibling control.
</p>
<p>
Changing the value for the property causes the <var>Change</var> method to be
called to notify and apply modifications to the associated Control, and to
signal the <var>OnChange</var> event handler (when assigned).
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder may be scaled by X
and Y scaling factors when the AutoAdjustLayout method is called.
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder are used in Control
methods which anchor or adjust the layout and size for the control instance on
its parent control.
</p>
<p>
Use Bottom to specify the border spacing on the bottom edge of the
associated Control.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.AutoAdjustLayout"/>
<link id="TWinControl.AlignControls"/>
<link id="TWinControl.Controls"/>
<link id="TWinControl.CalculatePreferredSize"/>
<link id="TControl.Parent"/>
<link id="TControl.DoAutoAdjustLayout"/>
<link id="TControl.AnchorToNeighbour"/>
<link id="TControl.AnchorAsAlign"/>
<link id="TSpacingSize"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.Right"> <element name="TControlBorderSpacing.Right">
<short>The space at the right border.</short> <short>
<descr/> The border space on the right edge of the associated control.
<seealso/> </short>
<descr>
<p>
<var>Right</var> is a <var>TSpacingSize</var> property which indicates the
number of pixels used as border spacing for the associated <var>Control</var>.
It specifies the minimum distance between either the right edge of the parent
control or the left edge of an adjacent sibling control.
</p>
<p>
Changing the value for the property causes the <var>Change</var> method to be
called to notify and apply modifications to the associated Control, and to
signal the <var>OnChange</var> event handler (when assigned).
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder may be scaled by X
and Y scaling factors when the AutoAdjustLayout method is called.
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder are used in Control
methods which anchor or adjust the layout and size for the control instance on
its parent control.
</p>
<p>
Use Left to specify the border spacing on the left-hand edge of the associated
Control.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.AutoAdjustLayout"/>
<link id="TWinControl.AlignControls"/>
<link id="TWinControl.Controls"/>
<link id="TWinControl.CalculatePreferredSize"/>
<link id="TControl.Parent"/>
<link id="TControl.DoAutoAdjustLayout"/>
<link id="TControl.AnchorToNeighbour"/>
<link id="TControl.AnchorAsAlign"/>
<link id="TSpacingSize"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.Bottom"> <element name="TControlBorderSpacing.Bottom">
<short>The space at the bottom border.</short> <short>
<descr/> The border space on the bottom edge of the associated control.
<seealso/> </short>
<descr>
<p>
<var>Bottom</var> is a <var>TSpacingSize</var> property which indicates the
number of pixels used as border spacing for the associated <var>Control</var>.
It specifies the minimum distance between either the bottom edge of the parent
control or the top edge of an adjacent sibling control.
</p>
<p>
Changing the value for the property causes the <var>Change</var> method to be
called to notify and apply modifications to the associated Control, and to
signal the <var>OnChange</var> event handler (when assigned).
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder may be scaled by X
and Y scaling factors when the AutoAdjustLayout method is called.
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder are used in Control
methods which anchor or adjust the layout and size for the control instance on
its parent control.
</p>
<p>
Use Bottom to specify the border spacing on the bottom edge of the
associated Control.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Around"/>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.AutoAdjustLayout"/>
<link id="TWinControl.AlignControls"/>
<link id="TWinControl.Controls"/>
<link id="TWinControl.CalculatePreferredSize"/>
<link id="TControl.Parent"/>
<link id="TControl.DoAutoAdjustLayout"/>
<link id="TControl.AnchorToNeighbour"/>
<link id="TControl.AnchorAsAlign"/>
<link id="TSpacingSize"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.Around"> <element name="TControlBorderSpacing.Around">
<short>The space to add on each side of a control.</short> <short>
<descr/> The border space on each of the edges for the associated control.
<seealso/> </short>
<descr>
<p>
<var>Around</var> is a is a <var>TSpacingSize</var> property which indicates
the number of pixels used as border spacing for the associated
<var>Control</var>. It specifies the minimum distance between an edge on the
parent control or an adjacent edge on a sibling control.
</p>
<p>
Changing the value for the property causes the <var>Change</var> method to be
called to notify and apply modifications to the associated Control, and to
signal the <var>OnChange</var> event handler (when assigned).
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder may be scaled by X
and Y scaling factors when the AutoAdjustLayout method is called.
</p>
<p>
Values in Left, Right, Top, Bottom, Around, and InnerBorder are used in Control
methods which anchor or adjust the layout and size for the control instance on
its parent control. Around is applied independent of values in the Left, Right,
Top, or Bottom properties; the effective border spacing is always a sum of the
value in Around and the corresponding property for a given edge.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Top"/>
<link id="TControlBorderSpacing.Left"/>
<link id="TControlBorderSpacing.Right"/>
<link id="TControlBorderSpacing.Bottom"/>
<link id="TControlBorderSpacing.AutoAdjustLayout"/>
<link id="TWinControl.AlignControls"/>
<link id="TWinControl.Controls"/>
<link id="TWinControl.CalculatePreferredSize"/>
<link id="TControl.Parent"/>
<link id="TControl.DoAutoAdjustLayout"/>
<link id="TControl.AnchorToNeighbour"/>
<link id="TControl.AnchorAsAlign"/>
<link id="TSpacingSize"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.InnerBorder"> <element name="TControlBorderSpacing.InnerBorder">
<short> <short>
Space added to the widget's <link id="TControl.GetPreferredSize">preferred Space added to the <link id="TControl.GetPreferredSize">preferred
size</link> size</link> for the widget.
</short> </short>
<descr> <descr>
<p> <p>
When <link id="TControl.GetPreferredSize">calculating the preferred When <link id="TControl.GetPreferredSize">calculating the preferred
size</link> of control, the LCL asks the widget first. size</link> of the associated Control, the LCL checks the widget first.
</p> </p>
<p> <p>
When the widget returns a preferred size, e.g. a TButton widget, then the If the widget has a preferred size, such as a TButton widget, then the
InnerBorder is added twice to this size - e.g. to the Height for top and InnerBorder value is added to increase the Height or Width of the control at
bottom space. both of the opposing borders; Top and Bottom for preferred height, Left and
Right for preferred width.
</p> </p>
<p> <p>
If the widget does not return a preferred size, the InnerBorder has no effect. If the widget does not return a preferred size, the InnerBorder has no effect.
</p> </p>
<p>
Changing the value for the property causes the Change method to be called to
recalculate the preferred size for the associated Control, and to signal the
OnChange event handler (when assigned).
</p>
</descr> </descr>
<seealso/> <seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.OnChange"/>
<link id="TWinControl.CalculatePreferredSize"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.CellAlignHorizontal"> <element name="TControlBorderSpacing.CellAlignHorizontal">
<short>The horizontal alignment inside a table cell.</short> <short>
<descr/> The horizontal alignment of the associated Control when the control ChildSizing
<seealso/> uses a tabular layout.
</short>
<descr>
<p>
<var>CellAlignHorizontal</var> is a <var>TControlCellAlign</var> property which
controls the horizontal alignment and sizing of the control when its Parent
uses a tabular layout for child controls. The default value for the property is
<var>caFill</var> and causes the control to be resized to horizontally fill the
cell where the control is displayed.
</p>
<p>
See <link id="TControlCellAlign">TControlCellAlign</link> for more information
about the values in the enumeration and their meanings.
</p>
<p>
Changing the value for the property causes the Change method to be called to
recalculate the preferred size for the associated Control, and to signal the
OnChange event handler (when assigned).
</p>
<p>
The value in CellAlignHorizontal is used when the AlignControls method in the
associated Control is called.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.CellAlignVertical"/>
<link id="TControlCellAlign"/>
<link id="TWinControl.ChildSizing"/>
<link id="TWinControl.AlignControls"/>
</seealso>
</element> </element>
<element name="TControlBorderSpacing.CellAlignVertical"> <element name="TControlBorderSpacing.CellAlignVertical">
<short>The vertical alignment inside a table cell.</short> <short>
<descr/> The vertical alignment of the associated Control when the control ChildSizing
<seealso/> uses a tabular layout.
</short>
<descr>
<p>
<var>CellAlignVertical</var> is a <var>TControlCellAlign</var> property which
controls the vertical alignment and sizing of the control when its Parent
uses a tabular layout for child controls. The default value for the property is
<var>caFill</var> and causes the control to be resized to vertically fill the
cell where the control is displayed.
</p>
<p>
See <link id="TControlCellAlign">TControlCellAlign</link> for more information
about the values in the enumeration and their meanings.
</p>
<p>
Changing the value for the property causes the Change method to be called to
recalculate the preferred size for the associated Control, and to signal the
OnChange event handler (when assigned).
</p>
<p>
The value in CellAlignVertical is used when the AlignControls method in the
associated Control is called.
</p>
</descr>
<seealso>
<link id="TControlBorderSpacing.Control"/>
<link id="TControlBorderSpacing.Change"/>
<link id="TControlBorderSpacing.CellAlignHorizontal"/>
<link id="TControlCellAlign"/>
<link id="TWinControl.ChildSizing"/>
<link id="TWinControl.AlignControls"/>
</seealso>
</element> </element>
<element name="TAnchorSideChangeOperation"> <element name="TAnchorSideChangeOperation">