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 width anchorage rate (Property AnchorRateWidth) is applied if the field is anchored in width (constant anchorWidth used for Property Anchoring).

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 on 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 on 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 on 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, the Property Anchoring allows to define the behavior of the control (dimensions and displacement) when changing the window size. 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.
Anchoring is not available for a column found in a Table or TreeView Table control. The anchorage of a column is specified directly with the Property AnchorRateWidth.
Versions 19 and later
In a report, Anchoring is used to find out the control behavior (dimension and move) when resizing the report. This behavior was defined in the report editor.
For more details, see Anchoring controls in a report.
New in version 19
In a report, Anchoring is used to find out the control behavior (dimension and move) when resizing the report. This behavior was defined in the report editor.
For more details, see Anchoring controls in a report.
In a report, Anchoring is used to find out the control behavior (dimension and move) when resizing the report. This behavior was defined in the report editor.
For more details, see Anchoring controls in a report.

Limits

The Property AnchorRateWidth applies to all fields in a window.

Versions 19 and later

The Property AnchorRateWidth applies to all fields of an report. In this case, you can only find out the anchor rate used.

New in version 19

The Property AnchorRateWidth applies to all fields of an report. In this case, you can only find out the anchor rate used.

The Property AnchorRateWidth applies only to the following items:

Button.
Libellé.
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.