Y (Property)

Find out the Y coordinate of a control or window (position on Y axis).
This property is used to find out the Y coordinate of a control in a page.
Modify the Y coordinate of a control or window (position on Y axis).
This property is used to modify the Y coordinate of a stackable control in a page.

This property can be used on the controls found in a window, in a page or in a report, and on the windows.

Versions 16 and later

This property is now available for PHP sites.

New in version 16

This property is now available for PHP sites.

This property is now available for PHP sites.

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.

This property is now available for report controls in iPhone/iPad applications.

New in version 18

This property is now available in Windows Store apps mode.

This property is now available for report controls in iPhone/iPad applications.

This property is now available in Windows Store apps mode.

This property is now available for report controls in iPhone/iPad applications.

Versions 20 and later

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

New in version 20

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

Versions 21 and later

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

Example

// Find out the Y coordinate of "IMG_Image"
ResYCoordinate = IMG_Image.Y

Syntax

Finding out the Y coordinate of a control or window Hide the details

<Result> = <Element used>.Y

<Result>: Integer

Y coordinate of specified control:
in a window, this Y coordinate is expressed in pixels. This Y-coordinate corresponds the vertical 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).
in a report, this Y coordinate is expressed in millimeters. This Y coordinate corresponds to the vertical position of top left corner of control in relation to the top left corner of the block to which the control belongs.
in a page, this Y coordinate is expressed in pixels.
It corresponds to the vertical position of top left corner of control in relation to the top left corner of the page. If the control belongs to a container control (HTML cell, looper, ...), the Y coordinate is given in relation to this container control.
It corresponds to the vertical position of top left corner of control in relation to the top left corner of the page.
Y-coordinate of the specified window (in pixels). Vertical position of top left corner of window in relation to the top left corner of the screen.
The Y coordinate of window is not available.

<Element used>: Control name or window name

Name of element (control or window) to use.
For a control associated with a tab, use the following notation:

<Tab name>.<Control name>

Modifying the Y coordinate of a control or window Hide the details

<Element used>: Control name or window name

Name of element whose Y coordinate will be modified.
For a control associated with a tab, use the following notation:

<Tab name>.<Control name>

To modify the Y coordinate of a page control, this control must be a stackable control.

<New Y coordinate>: Integer

New Y coordinate for the specified control:
in a window, this Y coordinate is expressed in pixels. This Y-coordinate corresponds the vertical 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).
in a report, this Y coordinate is expressed in millimeters. This Y coordinate corresponds to the vertical position of top left corner of control in relation to the top left corner of the block to which the control belongs.
in a page, this Y coordinate is expressed in pixels.
It corresponds to the vertical position of top left corner of control in relation to the top left corner of the page. If the control belongs to a container control (HTML cell, looper, ...), the Y coordinate is given in relation to this container control.
It corresponds to the vertical position of top left corner of control in relation to the top left corner of the page.
Remark: The control must be a stackable control otherwise the modification of the Y coordinate will be ignored.
New Y coordinate for the specified window (in pixels). Vertical position of top left corner of window in relation to the top left corner of the screen.
The Y coordinate of window cannot be modified.

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 XInitial and YInitial. This position corresponds to the position of the object when the window is opened and can be modified by programming with the properties X and Y.

Position of Tab control

The Property Y allows you to know and modify the vertical position (in pixels) of the Tab control in relation to the top left corner of the client area of the window (i.e. the window without the title and menu bars nor the Border).

Important: If the coordinates of the tab are modified with the Property Y, all the fields positioned on the tab are also moved.

Position of control in a Tab control

If a control is associated with a tab, its coordinates are not relative to the tab but to the window's client area (i.e. the window without title bar, menu bar or borders).

If, after a modification, the coordinates of a control positioned on a tab no longer belong to the coordinates of this tab, the control is not displayed anymore.

Hidden button

It is possible to use a "hidden" button by using negative coordinates (with the properties Y and X).. 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 anchored control

If a field is anchored, the Property Y allows you to temporarily change its ordinate (until the next change in window size).

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

Toolbar

The Property Y can be used on a floating toolbar.

Versions 22 and later

Elements of a Looper control

The Property Y can be used on the elements of an Looper control. In this case, the Y property allows to know the coordinates of the repetition within the visible area of the Looper control.

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

Example:

LooperDisplay(LOOP_NoName1, 10)
ThreadPause(200)
Info(".Y of element 10: " + ZR_SansNom1[10].Y)

New in version 22

Elements of a Looper control

The Property Y can be used on the elements of an Looper control. In this case, the Y property allows to know the coordinates of the repetition within the visible area of the Looper control.

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

Example:

LooperDisplay(LOOP_NoName1, 10)
ThreadPause(200)
Info(".Y of element 10: " + ZR_SansNom1[10].Y)

Elements of a Looper control

The Property Y can be used on the elements of an Looper control. In this case, the Y property allows to know the coordinates of the repetition within the visible area of the Looper control.

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

Example:

LooperDisplay(LOOP_NoName1, 10)
ThreadPause(200)
Info(".Y of element 10: " + ZR_SansNom1[10].Y)

Limits for a window and for its controls

In windows, the Property Y cannot be used on:

an option in a check box or radio button,
a row in a list box, in a combo box or in a table,
a group of controls,
a window menu,
an element in a TreeView control.

In Java, Y only applies to the following elements:

Button.
Libellé.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
TreeView.
Tab.
Window.
Table.
Supercontrol.

Limits for the report controls

The Property Y cannot be used on:

a report,
a report block.

Remarks

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

Limits in the pages

The Property Y cannot be used on:

an HTML table,
an option in a check box or radio button,
a row in a list box, in a combo box or in a table,
a table cell,
a group of controls.