X (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

Initial position (control and window)
Hidden button
Position of an anchored control
Elements of a Looper control
Limits for the windows and window controls
Limits in the reports

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

X (Property)

In french: X

The X property is used to:

Get the X-coordinate of a control, Table control column or window (position on the X-axis).
Change the X-coordinate of a control or window (position on the X-axis).

This property can be used on a window or on controls in a window, page or report.

Example

// Connaître l'abscisse du champ "IMG_Image"
ResAbscisse = IMG_Image.X

Syntax

Finding out the X-coordinate of an element Hide the details

<Result> = <Element used>.X

<Result>: Integer

X-coordinate of specified element:
If the control belongs to a window, this X-coordinate is expressed in pixels. It corresponds to the horizontal position of the upper-left corner of the control relative to the upper-left corner of the window's client area (i.e. the window without title bar, menu bar or borders).
If the control belongs to a report, this X-coordinate is expressed in millimeters. It corresponds to the horizontal position of the upper-left corner of the element in relation to the upper-left corner of te block to which the control belongs.
If the control belongs to a page, this X-coordinate is expressed in pixels. It corresponds to:
X-coordinate of specified column in a Table control (in pixels). Horizontal position of the upper-left corner of column in relation to the upper-left corner of Table control.
X-coordinate of the specified window (in pixels). Horizontal position of the upper-left corner of the window in relation to the upper-left corner of the screen.

<Element used>: Character string

Name of element whose X-coordinate you want to get.
For a control associated with a tab, use the following notation:
<Nom de l'onglet>.<Nom du champ>

Modifying the X-coordinate of an element Hide the details

<Element used>: Character string

Name of element whose X-coordinate will be modified.
For a control associated with a tab, use the following notation:
<Nom de l'onglet>.<Nom du champ>

<New X-coordinate>: Integer

New X-coordinate of the specified control:
If the control belongs to a window, this X-coordinate is expressed in pixels. It corresponds to the horizontal position of the upper-left corner of the control relative to the upper-left corner of the window's client area (i.e. the window without title bar, menu bar or borders).
If the control belongs to a report, this X-coordinate is expressed in millimeters. It corresponds to the horizontal position of the upper-left corner of the element in relation to the upper-left corner of te block to which the control belongs.
If the control belongs to a page, this X-coordinate is expressed in pixels.
Note: The field must be superimposable for the change in its abscissa to take effect.
New Xcoordinate of specified column in a Table control (in pixels). Horizontal position of the upper-left corner of column in relation to the upper-left corner of Table control.
New X-coordinate for the specified window (in pixels). Horizontal position of the upper-left corner of the window in relation to the upper-left corner of the screen.

Remarks

Initial position (control and window)

The initial position (defined in the "Details" tab of the object description in the window editor) is returned by this XInitial and YInitial properties. It corresponds to position of the object when the window is opened, and can be modified through programming with the X and Y properties.

Hidden button

You can use a "hidden" button by specifying negative coordinates (with the X and Y properties). These negative coordinates can be used to define specific shortcuts for example. A specific process can be called from a button with negative coordinates so that it is not displayed in the window.

Position of an anchored control

The X property can be used to temporarily modify the X-coordinate of an anchored control (until the window is resized).

To permanently change the position of an anchored control, use the XInitial and YInitial properties.

Elements of a Looper control

The X property can be used on the elements of a Looper control. In this case, the X property is used to get the coordinates of the row inside the visible area of the Looper control.

If the element is not displayed in the visible part of the Looper control, the X property will return -4000.

Example:

LooperDisplay(ZR_SansNom1, 10)
ThreadPause(200)
Info(".X de l'élément 10 : " + ZR_SansNom1[10].X)

Limits for the windows and window controls

The X property does not apply to table columns.

Limits in the reports

The X property cannot be used on:

a report,
a report block.

Remark:

A control cannot be displayed outside the block to which it belongs.
The Height and Width properties are used to get the height and width of a report control or report block.