Previous Next Chapter

VIEW command

Purpose:

This command will change the position of the viewable display area of a window.

Format:

VIEW [WINDOW] <ROOT|ACTIVE|Drawer name> [PAGE|PIXEL] [UP|DOWN|LEFT|RIGHT]

Template:

VIEW WINDOW,PAGE/S,PIXEL/S,UP/S,DOWN/S,LEFT/S,RIGHT/S

Parameters:

WINDOW

Either ROOT" to change the Workbench root window view (where volume icons and AppIcons live), ACTIVE" to change the currently active Workbench window view or the fully qualified name of a drawer window to change. 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.

UP

Move the view up by about 1/8 of the window height. If PAGE is specified, moves the view up by a whole page. If PIXEL is specified, moves the view up by a single pixel.

DOWN

Move the view down by about 1/8 of the window height. If PAGE is specified, moves the view down by a whole page. If PIXEL is specified, moves the view down by a single pixel.

LEFT

Move the view left by about 1/8 of the window height. If PAGE is specified, moves the view left by a whole page. If PIXEL is specified, moves the view left by a single pixel.

RIGHT

Move the view right by about 1/8 of the window height. If PAGE is specified, moves the view right by a whole page. If PIXEL is specified, moves the view right by a single pixel.

Errors:

10 - If the named window view cannot be changed; this can also happen if you specified ACTIVE" as the 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 view changed 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.

To find out about a window`s current view position, use the GETATTR command and query the window`s WINDOW.VIEW.LEFT and WINDOW.VIEW.TOP attributes.

Example:

/* Change the root window view; move it up by a whole page. */
ADDRESS workbench

VIEW root PAGE UP

Top Previous Next Chapter