GET WINDOW RECT

Home

4D v20 R7

GET WINDOW RECT


GET WINDOW RECT ( left ; top ; right ; bottom {; window} )

Parameter	Type	Description
left	Longint	Left coordinate of window's contents area
top	Longint	Top coordinate of window's contents area
right	Longint	Right coordinate of window's contents area
bottom	Longint	Bottom coordinate of window's contents area
window	WinRef	Window reference number, or Frontmost window of current process, if omitted or MDI window if -1 (Windows)

Description

The GET WINDOW RECT command returns the coordinates of the window whose reference number is passed in window. If the window does not exist, the variable parameters are left unchanged.

If you omit the window parameter, GET WINDOW RECT applies to the frontmost window for the current process.

The coordinates are expressed relative to the top left corner of the contents area of the application window (Windows MDI mode) or to the main screen (macOS and Windows SDI mode). The coordinates return the rectangle corresponding to the contents area of the window (excluding title bars and borders).

Note: Under Windows, if you pass -1 in window, GET WINDOW RECT returns the coordinates of the application window (MDI window). These coordinates correspond to the contents area of the window (excluding menu bars and borders). In this case in SDI mode, GET WINDOW RECT returns (0;0;0;0) as coordinates.

Example

See example for the WINDOW LIST command.