AmigaOS Manual: Workbench ARexx Port

Workbench acts as an ARexx host under the name of "WORKBENCH". It supports a number of commands as will be described below. Note that for the ARexx interface to work, rexxsyslib.library must be installed (this library is part of a regular Workbench installation) and the RexxMast program must have been started.

ACTIVATEWINDOW command

Purpose

This command will attempt to make a window the active one.

Format

ACTIVATEWINDOW [WINDOW] <ROOT|Drawer name>

Template

ACTIVATEWINDOW WINDOW

Parameters

WINDOW

Either "ROOT" to activate the Workbench root window (where volume icons and AppIcons live) or the fully qualified name of a drawer window to activate. 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 activated. The error code will be placed in the WORKBENCH.LASTERROR variable.

Result

-

Notes

If you choose to have a window activated that is not the root 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

/* Activate the root window. */ ADDRESS workbench

ACTIVATEWINDOW root   /* Activate the "Work:" partition's window. */ ACTIVATEWINDOW 'Work:'