AnchorRateWidth (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Anchoring a control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AnchorRateWidth (Property)

In french: TauxAncrageLargeur

The AnchorRateWidth property is used to:

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).

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

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.
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.
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 can be used in all the controls of a window.

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

The AnchorRateWidth property can only be used with the following elements:

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