Sys.ObjectFromPoint Method (Sys Object)

Applies to TestComplete 15.0, last modified on November 17, 2021
This method is obsolete. See the Remarks section below.

Description

The Sys.ObjectFromPoint method lets you obtain the onscreen object (a window, popup window or a non-handled object) that contains the pixel specified by X and Y, relative to the screen. You can use the WindowToScreen method of an onscreen object to convert client-area coordinates to screen coordinates.

Declaration

Sys.ObjectFromPoint(X, Y, FindTransparent)

X [in]    Required    Integer    
Y [in]    Required    Integer    
FindTransparent [in]    Optional    Boolean Default value: False   
Result An onscreen object

Applies To

The method is applied to the following object:

Sys

Parameters

The method has the following parameters:

X

The horizontal coordinate (relative to the screen) of the desired pixel.

Y

The vertical coordinate (relative to the screen) of the desired pixel.

FindTransparent

Specifies whether to retrieve nonwindowed controls. A nonwindowed control is a control that cannot receive the focus, cannot be the parent of other controls, and does not have its own window. For example, TLabel and TShape are nonwindowed controls.

The default value is False and nonwindowed controls are not obtained and their parent onscreen object is returned instead.

Result Value

The onscreen object to which the specified pixel belongs.

Remarks

The Sys object: The Sys.ObjectFromPoint method is obsolete and supported only for backward compatibility. In TestComplete 4 and later, you should use the Sys.Desktop.ObjectFromPoint method.

See Also

ObjectFromPoint Method (Desktop Object)
WindowToScreen Method

Highlight search results