4D v16.3

GET WINDOW RECT

Home

 
4D v16.3
GET WINDOW RECT

GET WINDOW RECT 


 

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

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 (on Windows) or of the main screen (on Macintosh). 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).

Example  

See example for the WINDOW LIST command.



See also 

CONVERT COORDINATES
SET WINDOW RECT

 
PROPERTIES 

Product: 4D
Theme: Windows
Number: 443

This command has platform-specific behavior

 
HISTORY 

Modified: 4D 2003

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)