 |
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:
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