SET WINDOW RECT

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

Parameter	Type		Description
left	Integer	→	Global left coordinate of window's contents area
top	Integer	→	Global top coordinate of window's contents area
right	Integer	→	Global right coordinate of window's contents area
bottom	Integer	→	Global bottom coordinate of window's contents area
window	Integer	→	Window reference number, or Frontmost window of current process, if omitted
*	Operator	→	If omitted (default) = change window to foreground If passed = do not change the level of the window

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

Description

The SET WINDOW RECT command changes the global coordinates of the window whose reference number is passed in window. If the window does not exist, the command does nothing.

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

This command can resize and move the window, depending on the new coordinates passed.

The coordinates must be 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 indicate the rectangle corresponding to the contents area of the window (excluding title bars and borders).

Warning: Be aware that by using this command, you may move a window beyond the limits of the main window (on Windows) or of the screens (on Macintosh). To prevent this, use commands such as Screen width and Screen height to double-check the new coordinates of the window.

By default, executing this command automatically moves the window designated by the window parameter to the foreground (if this parameter is used). You can disable this by passing the * as the last parameter. In this case, the command no longer changes the original level ("z" coordinate) of the window.

This command does not affect form objects. If the window contains a form, the form objects are not moved or resized by the command (regardless of their properties). Only the window is modified. In order to modify a form window while taking the resizing properties and the objects it contains into account, you must use the RESIZE FORM WINDOW command.

Example 1

See example for the WINDOW LIST command.

Example 2

Given the following window:

After execution of the following line:

 SET WINDOW RECT(100;100;300;300)

The window appears as follows:

See also

CONVERT COORDINATES
DRAG WINDOW
GET WINDOW RECT
RESIZE FORM WINDOW