AnchorRateWidth (Property)

Find out the anchor rate when a control (or a table column) stretches on the horizontal axis.
Modify the anchor rate when a control (or a table column) stretches on the horizontal axis.

The anchor rate is used to define how the control is moved or resized in relation to the evolution of size of window (or report) to which it is anchored. The anchor rate corresponds to the percentage by which the control moves in relation to the window (or report). Therefore, if the anchor rate is set to 0, the control will not move ; if the anchor rate is set to 1000, the anchor of control will be normal.

The anchor rate in width (..AnchorRateWidth) is applied if the control is anchored in width (anchorWidth constant used with ..Anchor).

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 19 and later

This property is now available for report controls.

This property can only be used to find out the anchor rate of the blocks or controls found in a report.

New in version 19

This property is now available for report controls.

This property can only be used to find out the anchor rate of the blocks or controls found in a report.

This property is now available for report controls.

This property can only be used to find out the anchor rate of the blocks or controls found in a report.

Versions 20 and later

This property is now available for Table controls and table columns in Android and iPhone/iPad applications.

New in version 20

This property is now available for Table controls and table columns in Android and iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Example

// The List Box control is enlarged by 50% of the new window size (500 for 1000).
LIST_ListPersons..AnchorRateWidth = 500

Syntax

Finding out the anchor rate when enlarging a control anchored in width Hide the details

<Result> = <Control used>..AnchorRateWidth

<Result>: Integer

Anchor rate included between 0 (unstretched control) and 1000 (standard anchor)

<Control used>: Control name

Name of control (or column) to use. This control can be a control:
of a window.
Versions 20 and later
of a report.
New in version 20
of a report.
of a report.

Modifying the anchor rate when enlarging a control anchored in width Hide the details

<Control used>..AnchorRateWidth = <Anchor rate>

<Control used>: Control name

Name of control (or column) to use.

<Anchor rate>: Integer

New anchor rate included between 0 (unstretched control) and 1000 (standard anchor)

Remarks

Anchoring a control

In a window, ..Anchor is used to define the control behavior (dimensions and move) when resizing the window. If the control is associated with a Tab control, the anchor is defined in relation to the tab.
See Anchoring applied to window controls for more details.
..Anchor is not available for a column found in a Table or TreeView Table control. The anchor of a column is specified by ..AnchorRateWidth directly.
Versions 19 and later
In a report, ..Anchor is used to find out the control behavior (dimension and move) when resizing the report. This behavior was defined in the report editor.
See Anchoring controls in a report for more details.
New in version 19
In a report, ..Anchor is used to find out the control behavior (dimension and move) when resizing the report. This behavior was defined in the report editor.
See Anchoring controls in a report for more details.
In a report, ..Anchor is used to find out the control behavior (dimension and move) when resizing the report. This behavior was defined in the report editor.
See Anchoring controls in a report for more details.

Limits

..AnchorRateWidth applies to all the window controls.

Versions 19 and later

..AnchorRateWidth applies to all the report controls. In this case, you can only find out the anchor rate used.

New in version 19

..AnchorRateWidth applies to all the report controls. In this case, you can only find out the anchor rate used.

..AnchorRateWidth only applies to the following elements:

Button.
Static control.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
TreeView.
Tab.
Table.
Supercontrol.
Versions 18 and later
Ribbon group.
New in version 18
Ribbon group.
Ribbon group.