PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

  • 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 YInitial property is used to:
  • Find out the Y-coordinate:
    • of a control (position on Y-axis) when opening the window or the page.
    • of a window (position on Y-axis) when opening the window.
  • Modify the Y-coordinate of a control anchored "to the bottom" (position on the vertical axis) when opening the window.
  • Find out the Y-coordinate of a control in relation to its block (position in millimeters on the vertical axis) when opening the report.
Remark: The origin of a control or window corresponds to the Y-coordinate specified in the "UI" tab, in their description window.
This Y-coordinate defines the control or window position when opening the window, page or report.
Versions 15 and later
Android This property is now available for Android applications.
New in version 15
Android This property is now available for Android applications.
Android This property is now available for Android applications.
Versions 17 and later
iPhone/iPad This property is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for iPhone/iPad applications.
iPhone/iPad This property is now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for report controls in iPhone/iPad applications.
New in version 18
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for report controls in iPhone/iPad applications.
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for report controls in iPhone/iPad applications.
Versions 20 and later
AndroidiPhone/iPad This property is now available for Table controls in Android and iPhone/iPad applications.
New in version 20
AndroidiPhone/iPad This property is now available for Table controls in Android and iPhone/iPad applications.
AndroidiPhone/iPad This property is now available for Table controls in Android and iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Versions 23 and later
PHP This property is now available for PHP sites.
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Server codeWindowsLinux This property is now available for WEBDEV sites in Linux and in Windows.
New in version 23
PHP This property is now available for PHP sites.
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Server codeWindowsLinux This property is now available for WEBDEV sites in Linux and in Windows.
PHP This property is now available for PHP sites.
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Server codeWindowsLinux This property is now available for WEBDEV sites in Linux and in Windows.
Example
// Moves the control 10 millimeters to bottom
STC_Caption_Title.Y = STC_Caption_Title.Y + 10
// Restores the initial position
STC_Caption_Title.Y = STC_Caption_Title.YInitial
Syntax

Finding out the Y-coordinate of a control or window Hide the details

<Result> = <Element used>.YInitial
<Result>: Integer
  • Y-coordinate of specified control
    • in a window, this Y-coordinate is expressed in pixels. When the window is opened, this coordinate corresponds to the vertical 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).
    • in a report, this Y-coordinate is expressed in millimeters. This Y-coordinate corresponds, when opening the report, to the vertical position of the upper-left corner of the control in relation to the upper-left corner of the block to which the control belongs.
    • in a page, this Y-coordinate is expressed in pixels. It corresponds, when opening the page, to:
      • WEBDEV - Server code the vertical 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-Y-coordinate is relative to the latter.
      • WEBDEV - Browser codePHP the vertical position of the upper-left corner of the control in relation to the upper-left corner of the page.
  • Y-coordinate of specified window (in pixels) when it is opened. Vertical 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>
WINDEVUniversal Windows 10 AppAndroidiPhone/iPadIOS WidgetJavaUser code (UMC)

Modifying the Y-coordinate of a control anchored "to bottom" Hide the details

<Control used>.YInitial = <New Y-coordinate>
<Control used>: Control name
Name of the control to be used. If the control is not anchored to the bottom, the YInitial property has no effect.
For a control associated with a tab, use the following notation:
<Tab name>.<Control name>
<New Y-coordinate>: Integer
New Y-coordinate of specified control (in pixels).
Vertical 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 YInitial property is used to get and change the vertical position (in pixels) of the Tab control in relation to the upper-left corner of the window's client area (i.e. window without borders, title and menu bars).
Important: If the coordinates of the Tab control are changed with the YInitial property and if this Tab control is anchored at the bottom, all the control positioned on the Tab control are also moved.
WINDEVJavaUser code (UMC)

Position of a control in a Tab control

  • If a control is associated with a Tab control, the coordinates of this control 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 YInitial property only applies to the report controls.
WINDEVWINDEV Mobile In a window, the YInitial 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 in a TreeView control.
Java In Java, the YInitial 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 YInitial property cannot be used on:
  • an HTML table,
  • 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.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment