Copyright (c) Hyperion Entertainment and contributors.
Difference between revisions of "AmigaOS Manual: Workbench ARexx Port"
Jump to navigation
Jump to search
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> |