Y (Property)

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

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

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

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 object position when opening the window and it can be modified by programming with ..X and ..Y.

Position of Tab control

..Y is used to find out and modify the vertical position (in pixels) of the Tab control, relative to the upper-left corner of the window's client area (i.e. the window without title bar, menu bar or borders).

Important: If the tab coordinates are modified by ..Y, all controls positioned on the tab are moved accordingly.

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

You have the ability to use a "hidden" button by specifying negative coordinates (with ..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

..Y is used to temporarily modify the Y coordinate of an anchored control (until the window is resized).

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

Versions 22 and later

Elements of a Looper control

..Y can be used on the elements found in a Looper control. In this case, ..Y is used to find out the coordinates of the row inside the visible area of the Looper control.

If the element is not displayed in the visible area of the Looper control, ..Y will return -4000.

Example:

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

New in version 22

Elements of a Looper control

..Y can be used on the elements found in a Looper control. In this case, ..Y is used to find out the coordinates of the row inside the visible area of the Looper control.

If the element is not displayed in the visible area of the Looper control, ..Y will return -4000.

Example:

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

Elements of a Looper control

..Y can be used on the elements found in a Looper control. In this case, ..Y is used to find out the coordinates of the row inside the visible area of the Looper control.

If the element is not displayed in the visible area of the Looper control, ..Y will return -4000.

Example:

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

Limits for a window and for its controls

In the windows, ..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.

Limits for the report controls

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