Copyright (c) Hyperion Entertainment and contributors.

Difference between revisions of "AmigaOS Manual: Workbench ARexx Port"

From AmigaOS Documentation Wiki
Jump to navigation Jump to search
(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 03:05, 4 March 2019