ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Initial position (control and window)
  • Position of a Tab control
  • Position of a control associated with a Tab control
  • Hidden button
  • Position of an anchored control
  • Toolbar
  • Elements of a Looper control
  • Limits for the windows and window controls
  • Limits in the reports
  • Limits in the pages
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The X property is used to:
  • Get the X-coordinate of a control, Table control column or window (position on the X-axis).
    WEBDEV - Server codeWEBDEV - Browser codePHP This property is used to get the X-coordinate of a control in a page.
  • Change the X-coordinate of a control or window (position on the X-axis).
    WEBDEV - Server codeWEBDEV - Browser codePHP This property is used to change the X-coordinate of an overlayable control in a page.
This property can be used on a window or on controls in a window, page or report.
Example
// Find out the X-coordinate of "IMG_Image" control
ResX = IMG_Image.X
Syntax

Finding out the X-coordinate of an element Hide the details

<Result> = <Element used>.X
<Result>: Integer
  • X-coordinate of specified element:
    • If the control belongs to a window, this X-coordinate is expressed in pixels. 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 to the horizontal position of the upper-left corner of the element in relation to the upper-left corner of te block to which the control belongs.
    • If the control belongs to a page, this X-coordinate is expressed in pixels. It corresponds to:
      • WEBDEV - Server code 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.
      • WEBDEV - Browser codePHP the horizontal position of the upper-left corner of the control in relation to the upper-left corner of the page.
  • X-coordinate of specified column in a Table control (in pixels). Horizontal position of the upper-left corner of column in relation to the upper-left corner of Table control.
  • WINDEVWINDEV Mobile X-coordinate of the specified window (in pixels). Horizontal position of the upper-left corner of the window in relation to the upper-left corner of the screen.
    Linux The X-coordinate of window is not available.
<Element used>: Character string
Name of element whose X-coordinate is requested.
For a control associated with a tab, use the following notation:
<Tab name>.<Control name>

Modifying the X-coordinate of an element Hide the details

<Element used>.X = <New X-coordinate>
<Element used>: Character string
Name of element whose X-coordinate will be modified.
For a control associated with a tab, use the following notation:
<Tab name>.<Control name>
WEBDEV - Server codeWEBDEV - Browser code To modify the X-coordinate of a page control, this control must be a stackable control.
<New X-coordinate>: Integer
  • New X-coordinate of the specified control:
    • If the control belongs to a window, this X-coordinate is expressed in pixels. 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 to the horizontal position of the upper-left corner of the element in relation to the upper-left corner of te block to which the control belongs.
    • If the control belongs to a page, this X-coordinate is expressed in pixels.
      • WEBDEV - Server code 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.
      • WEBDEV - Browser codePHP the horizontal position of the upper-left corner of the control in relation to the upper-left corner of the page.
      Remark: The control must be a stackable control otherwise the modification of the X-coordinate will be ignored.
  • New Xcoordinate of specified column in a Table control (in pixels). Horizontal position of the upper-left corner of column in relation to the upper-left corner of Table control.
  • WINDEVWINDEV Mobile New X-coordinate for the specified window (in pixels). Horizontal position of the upper-left corner of the window in relation to the upper-left corner of the screen.
    Linux The X-coordinate of the window cannot be modified.
Remarks
WINDEVUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetApple WatchJavaUser code (UMC)

Initial position (control and window)

The initial position (defined in the "Details" tab of the object description in the window editor) is returned by this XInitial and YInitial properties. It corresponds to position of the object when the window is opened, and can be modified through programming with the X and Y properties.
WINDEVJavaUser code (UMC)

Position of a Tab control

The X property is used to get and change 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 the Tab control are modified with the X property, all controls positioned on the tab are moved accordingly.
WINDEVJavaUser code (UMC)

Position of a control associated with a Tab control

If a control is associated with a pane of 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, after a modification, the coordinates of a control positioned on a Tab control no longer belong to the coordinates of this Tab control, the control is not displayed anymore.
WINDEVUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetApple WatchJavaUser code (UMC)

Hidden button

You can use a "hidden" button by specifying negative coordinates (with the X and Y properties). 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.
WINDEVUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetApple WatchJavaUser code (UMC)

Position of an anchored control

The X property can be used to temporarily modify the X-coordinate of an anchored control (until the window is resized).
To permanently change the position of an anchored control, use the XInitial and YInitial properties.
WINDEVUser code (UMC)

Toolbar

The X property can be used on a floating toolbar.
WINDEVUniversal Windows 10 AppiPhone/iPadIOS WidgetUser code (UMC)

Elements of a Looper control

The X property can be used on the elements of a Looper control. In this case, the X property is used to get the coordinates of the row inside the visible area of the Looper control.
If the element is not displayed in the visible part of the Looper control, the X property will return -4000.
Example:
LooperDisplay(LOOP_NoName1, 10)
ThreadPause(200)
Info(".X of elment 10: " + LOOP_NoName1[10].X)
WINDEVAndroidiPhone/iPadIOS WidgetJavaUser code (UMC)

Limits for the windows and window controls

WINDEV The X property cannot be used on:
  • an option in a Check Box or Radio Button control,
  • a row in a List Box control, Combo Box control or Table control,
  • a group of controls,
  • a window menu,
  • an element in a TreeView control.
Java In Java, the X property applies only to the following elements:
  • Button.
  • Static.
  • Edit control.
  • Image.
  • Check Box.
  • Radio Button.
  • List Box.
  • Combo Box.
  • TreeView.
  • Tab.
  • Window.
  • Table.
  • Supercontrols.
AndroidiPhone/iPadIOS Widget The X property does not apply to table columns.
WINDEVWEBDEV - Server codeReports and QueriesUniversal Windows 10 AppiPhone/iPadIOS Widget

Limits in the reports

The X property cannot be used on:
  • a report,
  • a report block.
Remark:
  • A control cannot be displayed outside the block to which it belongs.
  • The Height and Width properties are used to get the height and width of a report control or report block.
WEBDEV - Server codeWEBDEV - Browser codePHP

Limits in the pages

The X 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.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/14/2023

Send a report | Local help