PointerX

Description

Determines the distance of the pointer from the left edge of the specified object.

Applies to

Any object or control

Syntax

objectname.PointerX ( )

Argument

Description

objectname

The name of the control or window for which you want the pointer's distance from the left edge. If you do not specify objectname, PointerX reports the distance from the left edge of the current sheet or window.


Return value

Integer. Returns the pointer's distance from the left edge of objectname in PowerBuilder units if it succeeds and -1 if an error occurs.

Examples

In a script for a control in a window, the following example stores the distance of the pointer from the edge of the window in the variable li_dist. If the pointer is 5 units from the left edge of the window, li_dist equals 5:

integer li_dist
li_dist = Parent.PointerX()

This statement in a control's RButtonDown script displays a pop-up menu m_Appl.M_Help at the cursor position:

m_Appl.m_Help.PopMenu(Parent.PointerX(), &
   Parent.PointerY())

If the previous example was part of the window's RButtonDown script, instead of a control in the window, the following statement displays the pop-up menu at the cursor position:

m_Appl.m_Help.PopMenu(This.PointerX(), &
   This.PointerY())

See also

PointerY

PopMenu

WorkSpaceHeight

WorkSpaceWidth

WorkSpaceX

WorkSpaceY