XInitial (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Position of a Tab control
Position of a control in a Tab control
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XInitial (Property)

In french: XInitial

The XInitial property is used to:

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

Note The abscissa of a field or window corresponds to the X coordinate of the "UI" tab in the field or window description in the editor.
This X-coordinate defines the control or window position when opening the window, page or report.

Example

// Déplace le champ de 10 millimètres vers la droite
LIB_Titre.X = LIB_Titre.X + 10
// Restaure la position initiale
LIB_Titre.X = LIB_Titre.XInitial

Syntax

Getting the X-coordinate of a control or window Hide the details

<Result> = <Element used>.XInitial

<Result>: Integer

Abscissa of specified element:
If the field belongs to a window this abscissa 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 field belongs to a state this abscissa is expressed in millimeters. It corresponds, when opening the report, to the horizontal position of the upper-left corner of the control in relation to the upper-left corner of the block.
If the field belongs to a page this abscissa is expressed in pixels. When the report is opened, it corresponds to:
the horizontal position of the upper-left corner of the control in relation to the upper-left corner of the page. If the control belongs to a container control (HTML cell, looper, etc.), the X-coordinate is given in relation to this container control.
the horizontal position of the upper-left corner of the control in relation to the upper-left corner of the page.
X-coordinate of window (in pixels) when it is opened. Horizontal position of the upper-left corner of the window in relation to the upper-left corner of the screen.

<Element used>: Control name or window name

Name of element (control or window) to use.
For a field associated with a tab, use the following notation:
<Tab name>.<Control name>

Changing the X-coordinate of a control anchored "to the right" Hide the details

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

<Control used>: Control name

Name of the control to be used. If the control is not anchored to the right, the XInitial property has no effect.
For a field associated with a tab, use the following notation:
<Tab name>.<Control name>

<New X-coordinate>: Integer

New X-coordinate of the 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 a Tab control

The XInitial property gets and sets the horizontal 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 coordinates of a "right" docked tab are modified with the XInitialproperty, all fields positioned on the tab are also moved.

Position of a 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 a report, the XInitial property only applies to the report controls.

The XInitial property 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, the XInitial property applies only to the following elements:

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

Limits in the pages
The XInitial property can only be used on controls that 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.