ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • 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.
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:
    • 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>
    Universal Windows 10 AppAndroidiPhone/iPadIOS Widget

    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

    Limits

    Universal Windows 10 AppiPhone/iPadIOS Widget For a report, the YInitial property only applies to the report controls.
    WINDEV 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.
    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