PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

X
Y
  • Position of a tab
  • Position of control in a Tab control
  • Limits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
..YInitial 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.
Note: The initial Y coordinate of a control or window corresponds to the Y coordinate of "Details" tab in the control or window description in the editor.
This Y coordinate defines the control or window position when opening the window, page or report.
Versions 16 and later
Universal Windows 10 App This property is now available for the Windows Phone applications.
New in version 16
Universal Windows 10 App This property is now available for the Windows Phone applications.
Universal Windows 10 App This property is now available for the Windows Phone applications.
Versions 15 and later
Android This property is now available for the Android applications.
New in version 15
Android This property is now available for the Android applications.
Android This property is now available for the Android applications.
Versions 17 and later
iPhone/iPad This property is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for the iPhone/iPad applications.
iPhone/iPad This property is now available for the 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 the report controls in the 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 the report controls in the 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 the report controls in the iPhone/iPad applications.
Versions 20 and later
AndroidiPhone/iPad This property is now available for the Table controls in the Android applications and in the iPhone/iPad applications.
New in version 20
AndroidiPhone/iPad This property is now available for the Table controls in the Android applications and in the iPhone/iPad applications.
AndroidiPhone/iPad This property is now available for the Table controls in the Android applications and in the 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 the 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 the 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 the 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 Name>..YInitial
<Result>: Integer
  • Y coordinate of specified control
    • in a window, this Y coordinate is expressed in pixels. This Y coordinate corresponds, when opening the window, to the vertical position of top left corner of control in relation to the top left corner of client area of window (which means the window without title bar, menu bar and border).
    • in a report, this Y coordinate is expressed in millimeters. This Y coordinate corresponds, when opening the report, to the vertical position of top left corner of control in relation to the top 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 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 Y coordinate is given in relation to this container control.
      • WEBDEV - Browser codePHP the vertical position of top left corner of control in relation to the top 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 Name>: Character string (with or without quotes)
Name of element (control or window) to use.
For a control associated with a tab, use the following notation:
<Tab Name>.<Control Name>
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

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

<Control Name>..YInitial = <New Y Coordinate>
<Control Name>: Character string (with or without quotes)
Name of control to use. ..YInitial has no effect if the control is not anchored "to bottom".
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 top left corner of control in relation to the top left corner of client area of window (which means the window without title bar, menu bar and border).
Remarks
WINDEVWindows MobileJavaUser code (UMC)

Position of a tab

..YInitial is used to find out and modify the vertical position (in pixels) of a tab in relation to the top left corner of client area of window (which means the window without title bar, menu bar and border).
Important: If the tab coordinates are modified by ..YInitial and if this tab is anchored "to bottom", all controls positioned on the tab are also moved.
WINDEVWindows MobileJavaUser code (UMC)

Position of control in a Tab control

  • If a control is associated with a tab, the coordinates of this control are not given in relation to the Tab control but in relation to the client area of window (which means the window without title bar, menu bar and border).
  • If a control is positioned on a tab without being associated with this tab, the coordinates of this control are given in relation to the client area of window (which means the window without title bar, menu bar and border).

Limits

WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadWindows MobileUniversal Windows 10 App In a report, ..YInitial only applies to the controls found in the report.
WINDEVWINDEV Mobile In a window, ..YInitial 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.
WINDEV Limits for the controls and windows
In Windows 98, the size of elements is limited to ± 32 767. In Windows NT/2000, it is possible (but not recommended) to specify a size up to ± 2 147 483 647.
Java In Java, ..YInitial only applies 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
..YInitial 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 required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment