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 be resized. If it is set to 1000, the control will be resized normally.

The horizontal anchor rate (AnchorRateWidth property) is applied if the control is anchored horizontally(anchorWidth constant used with the Anchor property).

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

Getting the anchor rate when enlarging a control horizontally 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.

Changing the anchor rate when enlarging a control horizontally 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, the Anchor property is used to determine how a control is resized or moved when the window is resized. If the control is associated with a Tab control, the anchor is defined in relation to the tab.
For more details, see Anchoring applied to window controls.
The Anchor property is not available for columns in Table or TreeView Table controls. The anchors of a column can be specified directly with the AnchorRateWidth property.
Versions 19 and later
In a report, the Anchor property is used to find out how the control is resized or moved when the report is resized. This behavior was defined in the report editor.
For more details, see Anchoring controls in a report.
New in version 19
In a report, the Anchor property is used to find out how the control is resized or moved when the report is resized. This behavior was defined in the report editor.
For more details, see Anchoring controls in a report.
In a report, the Anchor property is used to find out how the control is resized or moved when the report is resized. This behavior was defined in the report editor.
For more details, see Anchoring controls in a report.

Limitations

The AnchorRateWidth property applies to all the controls in a window.

Versions 19 and later

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

New in version 19

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

The AnchorRateWidth property applies only 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.