Applies to
Controls, windows, PDFVisibleContent, PDFImage, PDFImportContent, PDFMultilineText, PDFRichText, PDFSharedText, PDFText
Description
The Y property specifies the Y coordinate of an object or control. The Y coordinate is the distance from the top of the window or user object. If the object is a main window or custom user object, the distance is relative to the screen. If it is not a main window, the distance is relative to the parent window unless it is opened in an MDI frame window, in which case the distance is relative to the MDI frame.
Datatype
Long in PowerBuilder units (the maximum value is 32,765) for controls and windows
Double in point (pt) for PDFVisibleContent, PDFImage, PDFImportContent, PDFMultilineText, PDFRichText, PDFSharedText, PDFText
Usage
In a painter (when available)
To set the Y coordinate:
-
Enter the desired Y coordinate, in PowerBuilder units, in the Y field of the Other tab page of the object's Properties view, or drag and drop the control to the desired location.
In scripts
In controls and windows, the Y property takes an integer value. The following line sets the distance from the top of the window for a DataWindow control dw_1:
dw_1.Y = 215
You can also set the X and Y properties of a control using the Move function.
It is illegal to move a maximized sheet or frame. Changing the X or Y property for a maximized window is ignored.
In PDFVisibleContent, PDFImage, PDFImportContent, PDFMultilineText, PDFRichText, PDFSharedText, and PDFText, the Y property takes a double value. The unit is point (pt).
