Skip to main content
Version: 20 R7 BETA

Find window

Find window ( left ; top {; windowPart} ) : WinRef

ParameterTypeDescription
leftIntegerGlobal left coordinate
topIntegerGlobal top coordinate
windowPartInteger3 if window is "touched", 0 otherwise
Function resultWinRefWindow reference number

This command is not thread-safe, it cannot be used in preemptive code.

Description

The Find window command returns (if any) the reference number of the first window “touched” by the point whose coordinates passed in left and top.

The coordinates must be expressed relative to the top left corner of the contents area of the application window (Windows) or to the main screen (Macintosh).

The windowPart parameter returns 3 if the window is touched, and 0 otherwise. (Compatibility note: Starting with 4D v14, the constants of the Find Window theme are obsolete).

See also

Frontmost window
Next window