YInitial (Property)

Find out the Y coordinate:
- of a control (position on Y axis) when opening the window or the page.
- of a window (position on Y axis) when opening the window.
Modify the Y coordinate of a control anchored "to the bottom" (position on the vertical axis) when opening the window.
Find out the Y coordinate of a control in relation to its block (position in millimeters on the vertical axis) when opening the report.

Remark: The origin of a control or window corresponds to the Y coordinate specified in the "UI" tab, in their description window.
This Y coordinate defines the control or window position when opening the window, page or report.

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

Versions 23 and later

This property is now available for WEBDEV sites in Linux and in Windows.

New in version 23

This property is now available for WEBDEV sites in Linux and in Windows.

Example

// Moves the control 10 millimeters to bottom
LIB_Libellé_Titre.Y = LIB_Libellé_Titre.Y + 10
// Restores the initial position
LIB_Libellé_Titre.Y = LIB_Libellé_Titre.YInitial

Syntax

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

<Result> = <Element used>.YInitial

<Result>: Integer

Y coordinate of specified control
in a window, this Y coordinate is expressed in pixels. When the window is opened, this coordinate corresponds to 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, when opening the report, 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, when opening the page, to:
Y-coordinate of specified window (in pixels) when it is opened. 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 anchored "to bottom" Hide the details

<Control used>.YInitial = <New Y coordinate>

<Control used>: Control name

Name of control to use. If this field is not anchored "down", the Property YInitial has no effect..
For a control associated with a tab, use the following notation:

<Tab name>.<Control name>

<New Y coordinate>: Integer

New Y coordinate of specified control (in pixels).
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).

Remarks

Position of Tab control

The Property YInitial 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 control are modified with the YInitial property and if this Tab control is anchored "down", all fields positioned on the Tab control are also moved.

Position of control in a Tab control

If a control is associated with a Tab control, the coordinates of this control are not relative to the Tab control, but to the window's client area (i.e. the window without title bar, menu bar or borders).
If a control is positioned on a Tab control without being associated with it, the coordinates of this control are relative to the window's client area (i.e. the window without title bar, menu bar or borders).

Limits

For an report, the YInitial property only applies to the report fields.

In a window, the Property YInitial 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 table cell,
a group of controls,
a window menu,
an element in a TreeView control.

In Java, YInitial only applies to the following elements:

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