Previous Next Chapter

WINDOW command

Purpose:

This command will change, open, close or snapshot windows.

Format:

WINDOW [WINDOWS] <Window name> .. <Window name> [OPEN|CLOSE] [SNAPSHOT] [ACTIVATE] [MIN|MAX] [FRONT|BACK] [CYCLE PREVIOUS|NEXT]

Template:

WINDOW WINDOWS/M/A,OPEN/S,CLOSE/S,SNAPSHOT/S,ACTIVATE/S,MIN/S,MAX/S, FRONT/S,BACK/S,CYCLE/K

Parameters:

WINDOWS

Names of the windows to operate on. This can be ROOT" to for the Workbench root window (where volume icons and AppIcons live), ACTIVE" for the currently active Workbench window or the fully qualified name of a drawer window.

OPEN

Attempt to open the specified windows.

CLOSE

Close the specified windows. Note that if a window is closed no further operations (such as SNAPSHOT, ACTIVATE, etc.) can be performed on it.

SNAPSHOT

Snapshot the sizes and positions of the specified windows.

ACTIVATE

Activate the specified windows. With multiple windows to activate, only one window will wind up as the active one. Commonly, this will be the last window in the list.

MIN

Resize the windows to their minimum dimensions.

MAX

Resize the windows to their maximum dimensions.

FRONT

Move the windows into the foreground.

BACK

Move the windows into the background.

CYCLE

This command operates on the currently active drawer window. You can specify either PREVIOUS", to activate the previous drawer window in the list, or NEXT", to activate the next following drawer window in the list.

Errors:

10 - If the named windows cannot be opened or operated on; this can also happen if you specified ACTIVE" as a window name and none of the Workbench windows is currently active. The error code will be placed in the WORKBENCH.LASTERROR variable.

Result:

-

Notes:

If you choose to have a window operated on that is neither the root nor the active window you must make sure that the window name is given as a fully qualified path name. For example Work:" is a fully qualified name, and so is SYS:Utilities". Devs/Printers" would not be a fully qualified name. A fully qualified name always contains the name of an assignment, a volume or a device.

Example:

/* Open the Work:" drawer. */
ADDRESS workbench

WINDOW ,Work:` OPEN

/* Activate the root window. */
WINDOW root ACTIVATE

Top Previous Next Chapter