Previous Next Chapter

WINDOWTOFRONT command

Purpose:

This command will bring a window to the foreground.

Format:

WINDOWTOFRONT [WINDOW] <ROOT|ACTIVE|Drawer name>

Template:

WINDOWTOFRONT WINDOW

Parameters:

WINDOW

ROOT" to bring the the Workbench root window (where volume icons and AppIcons live) to the foreground, ACTIVE" to bring the currently active Workbench window to the foreground or the fully qualified name of a drawer window. Note that the drawer window must already be open.

If no WINDOW parameter is specified, this command will try to operate on the currently active Workbench window.

Errors:

10 - If the named window cannot be found. The error code will be placed in the WORKBENCH.LASTERROR variable.

Result:

-

Notes:

If you choose to have a window brought to the foreground that is not the root window or the currently 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:

/* Bring the root window to the foreground. */ ADDRESS workbench

WINDOWTOFRONT root

Top Previous Next Chapter