AnchorRateHeight (Property)

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 vertical anchor rate (AnchorRateHeight property) is applied if the control is anchored to the top (anchorHeight 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 20 and later

This property is now available on report controls.

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

This property can only be used to find out the anchor rate of the report controls.

New in version 20

This property is now available on report controls.

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

This property can only be used to find out the anchor rate of the report controls.

This property is now available on report controls.

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

This property can only be used to find out the anchor rate of the report controls.

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 will be resized by 50% relative to the window size.
LIST_ListPersons.AnchorRateHeight = 500

Syntax

Finding out the anchor rate of a control with a vertical anchor Hide the details

<Result> = <Control used>.AnchorRateHeight

<Result>: Integer

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

<Control used>: Control name

Name of the control to be used. This control can be a control:
in a window.
Versions 20 and later
in a report.
New in version 20
in a report.
in a report.

Modifying the anchor rate of a control with a vertical anchor Hide the details

<Control used>.AnchorRateHeight = <Anchor rate>

<Control used>: Control name

Name of the control to be used.

<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.
Versions 20 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 20
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.

Limits

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

Versions 20 and later

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

New in version 20

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

The AnchorRateHeight property applies only to the following elements:

Button.
Static.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
TreeView.
Tab.
Table.
Supercontrol.