XInitial (Property)

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

Note: The X coordinate of a control or window corresponds to the X coordinate of "Details" tab in the description window of control or window.
This X coordinate defines the control or window position when opening the window, page or report.

Versions 16 and later

This property is now available for the Windows Phone applications.

New in version 16

This property is now available for the Windows Phone applications.

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 right
STC_Title..X = STC_Title..X + 10
// Restores the initial position
STC_Title..X = STC_Title..XInitial

Syntax

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

<Result> = <Element name>..XInitial

<Result>: Integer

X coordinate of specified element:
If the control belongs to a window: this X coordinate is expressed in pixels. It corresponds, when opening the window, to the horizontal position of top left corner of control in relation to the top left corner of client area of window (which means the window without title bar, menu bar and border).
If the control belongs to a report: this X coordinate is expressed in millimeters. It corresponds, when opening the report, to the horizontal position of top left corner of control in relation to the top left corner of block.
If the control belongs to a page: this X coordinate is expressed in pixels. It corresponds, when opening the report, to:
X coordinate of window (in pixels) when it is opened. Horizontal position of top left corner of window in relation to the top left corner of the screen.

<Element name>: Character string (with or without quotes)

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 X coordinate of a control anchored "to right" Hide the details

<Control name>..XInitial = <New X coordinate>

<Control name>: Character string (with or without quotes)

Name of control to use. ..XInitial has no effect if the control is not anchored "to right".
For a control associated with a tab, use the following notation:

<Tab name>.<Control name>

<New X coordinate>: Integer

New X coordinate of specified control (in pixels). Horizontal position of top left corner of control in relation to the top left corner of window client area (which means the window without title bar, menu bar and border).

Remarks

Position of Tab control

..XInitial is used to find out and modify the horizontal position (in pixels) of Tab control in relation to the top left corner of client area of window (which means the window without title bar, menu bar and border).

Important: If the coordinates of a tab anchored "to right" are modified by ..XInitial, all controls positioned on the tab will also be moved.

Position of control in a tab

If a control is associated with a tab, the coordinates of this control are not specified in relation to the tab but in relation to the client area of window (which means the window without title bar, menu bar and border).
If a control is positioned on a tab without being associated with this tab, the coordinates of this control are specified in relation to the client area of window (which means the window without title bar, menu bar and border).

Limits

For the reports, ..XInitial only applies to the controls found in a report.

..XInitial 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 of a TreeView control.

Limits for the controls and windows
In Windows 98, the size of elements is limited to ± 32 767. In Windows NT/2000, it is possible (but not recommended) to specify a size up to ± 2 147 483 647.

In Java, ..XInitial only applies to the following elements:

Button.
Static control.
Edit control.
Image.
Check box.
Radio button.
List box.
Combo box.
TreeView.
Tab.
Window.
Table.
Supercontrol.