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.

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

This property can only be used in the report editor.

Versions 16 and later

This property is now available for Windows Phone applications.

New in version 16

This property is now available for Windows Phone applications.

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

This property is now available in browser code.

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

New in version 23

This property is now available for PHP sites.

This property is now available in browser code.

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

This property is now available for PHP sites.

This property is now available in browser code.

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

<Result>: Integer

X coordinate of specified element:
If the control belongs to a window: this X-coordinate is expressed in pixels. When the window is opened, 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, 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:
the horizontal 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 X coordinate is given in relation to this container control.
the horizontal position of top left corner of control in relation to the top left corner of the page.
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 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 X coordinate of a control anchored "to right" Hide the details

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

<Control used>: Control name

Name of control to use. If this field is not anchored "right", the Property XInitial has no effect..
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 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 XInitial allows you to know and modify the horizontal 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 a tab anchored "on the right" are modified with the Property XInitial, 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 control, its coordinates 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 reports, the Property XInitial applies only to ' fields of an report.

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

In Java, XInitial 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 in the pages
The Property XInitial can only be used on the fields actually displayed in the browser.. It cannot be used on:
an HTML table,
an option in a Check Box or Radio Button control,
a row in a List Box control, Combo Box control or Table control,
a cell in a Table control,
a group of controls.

See also

X (Property)
Y (Property)
YInitial (Property)
Properties associated with reports and controls
Properties associated with the windows, the pages and the controls

Minimum version required

Version 9

This page is also available for…

WINDEV Mobile
WINDEV
WEBDEV
Reports & Queries

Comments

Click [Add] to post a comment

Last update: 02/18/2021

Send a report | Local help