ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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
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 XInitial property is used to:
  • Get the X-coordinate:
    • 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.
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.
Example
// Moves the control 10 millimeters to the right
STC_Title.X = STC_Title.X + 10
// Restores the initial position
STC_Title.X = STC_Title.XInitial
Syntax

Getting 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 the upper-left corner of the control in relation to the upper-left corner of the block.
    • If the control belongs to a page: this X-coordinate is expressed in pixels. It corresponds, when opening the report, 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.
  • WINDEVUniversal Windows 10 AppAndroidiPhone/iPadIOS Widget 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 control associated with a tab, use the following notation:
<Tab name>.<Control name>
WINDEVUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetJavaUser code (UMC)

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 control 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
WINDEVJavaUser code (UMC)

Position of a Tab control

The XInitial 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 a tab anchored to the right are changed with the XInitial property, all the controls positioned on the tab will also be moved.
WINDEVJavaUser code (UMC)

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

WINDEVWEBDEV - Server codeReports and QueriesUniversal Windows 10 AppiPhone/iPadIOS Widget For a report, the XInitial property only applies to the report controls.
WINDEVWINDEV Mobile 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.
Java 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.
WEBDEV - Server codeWEBDEV - Browser codePHP 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.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help