Copyright (c) Hyperion Entertainment and contributors.

AmigaOS Manual: Workbench ARexx Port: Difference between revisions

From AmigaOS Documentation Wiki
Jump to navigation Jump to search
Content deleted Content added
Steven Solie (talk | contribs)
Created page with "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, rexxsysl..."
 
Moved to the Workbench manual.
 
(52 intermediate revisions by 3 users not shown)
Line 1: Line 1:
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:
: <syntaxhighlight>
/* Activate the root window. */ ADDRESS workbench
ACTIVATEWINDOW root

/* Activate the "Work:" partition's window. */
ACTIVATEWINDOW 'Work:'
</syntaxhighlight>

Latest revision as of 01:05, 4 March 2019