X

Applies to

Controls, windows, PDFVisibleContent, PDFImage, PDFImportContent, PDFMultilineText, PDFRichText, PDFSharedText, PDFText

Description

The X property specifies the X coordinate of an object or control.

The X coordinate is the distance from the left edge of the window or custom 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 for PDFVisibleContent, PDFImage, PDFImportContent, PDFMultilineText, PDFRichText, PDFSharedText, PDFText. The unit is point (pt).

Usage

In a painter (when available)

To set the X coordinate:

  • Enter the desired X coordinate, in PowerBuilder units, in the X 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 X property takes an integer value. The following line sets the distance from the left edge of a window for a DataWindow control dw_1:

dw_1.X = 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 X property takes a double value. The unit is point (pt).