hiGetDbuPoint

hiGetDbuPoint( 
w_windowId 
) 
=> l_point / nil

Description

Returns the current location of the pointer, or nil if the pointer is not within the drawable area of the window or the window is hidden behind other tabs in a session window.

Even if the pointer is currently over another window that obscures w_windowId, this function returns its location as long as it it is within the boundaries of w_windowId.

Before returning the current location of the pointer, hiGetDbuPoint calls the appropriate transform and adjust procedures.

Argument

w_windowId

The window ID. w_window can be any window outside a session window or a graphics window within a session window. w_window cannot be a dockable window.

Value Returned

l_point	Location of the pointer in database units.
nil	The pointer is not within the drawable area of the window or w_window is hidden behind other tabs in a session window.

Related Topics

Window Functions

hiOpenWindow

hiGetDrawThruDelta

Return to top