Previous Next Chapter

MENU command

Purpose:

This command is for invoking items of the Workbench menu, as if the user had selected them with the mouse and for adding/removing user menus.

Format:

MENU [WINDOW <Window name>] [INVOKE] <Menu name> [NAME <Menu name>] [TITLE <Menu title>] [SHORTCUT <Menu shortcut>] [ADD|REMOVE] [CMD <ARexx command>]

Template:

MENU WINDOW/K,INVOKE,NAME/K,TITLE/K,SHORTCUT/K,ADD/S,REMOVE/S,CMD/K/F

Parameters:

The following set of parameters can be used solely for invoking menu items.

WINDOW

Name of the window whose menu should be invoked. This can be ROOT" to work on the Workbench root window (where volume icons and AppIcons live), ACTIVE" to work on the currently active Workbench window or the fully qualified name of a drawer window. 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.

INVOKE

Name of the menu to invoke. See below for a list of available menu items.

The following set of parameters are for adding and removing menu items.

NAME

Name of the menu item to add or remove. Each menu item must have a name with which it is associated. The name must be unique and has nothing to do with the title of the item, as shown in the Tools" menu.

TITLE

This is the text that will be used as the menu item title, as it will appear in the Tools" menu. This parameter is required if you ADD a new menu item.

SHORTCUT

When adding a new menu item, this will be the menu shortcut associated with the item. Please note that the shortcut cannot be longer than a single character and that it will be ignored if there already is an item in any of the menus which uses this shortcut. This parameter is optional.

ADD

This tells the MENU command to add a new item to the Tools" menu. When adding a menu item you will also need to specify the NAME, TITLE and CMD parameters.

REMOVE

This tells the MENU command to remove a menu item previously added via the ARexx interface. When removing a menu item you will also need to specify the NAME parameter.

CMD

This is the ARexx command to bind to the new menu item. The command can either be the name of an ARexx script to execute or a short ARexx program in a single line.

Menu items:

WORKBENCH.BACKDROP

Toggles the Workbench Backdrop" window switch.

WORKBENCH.EXECUTE

Invokes the Workbench Execute Command" requester. The user will be prompted to enter the command to be executed.

WORKBENCH.REDRAWALL

Invokes the Workbench Redraw All" function.

WORKBENCH.UPDATEALL

Invokes the Workbench Update All" function.

WORKBENCH.LASTMESSAGE

Redisplays the last Workbench error message.

WORKBENCH.ABOUT

Displays the Workbench About..." requester.

WORKBENCH.QUIT

Attempts to close Workbench; this may bring up a requester the user will have to answer.

WINDOW.NEWDRAWER

Prompts the user to enter the name of a new drawer to be created.

WINDOW.OPENPARENT

If possible, this will open the parent directory of the drawer the command operates on.

WINDOW.CLOSE

If possible, this will close the drawer the command operates on.

WINDOW.UPDATE

This will update the drawer the command operates on, i.e. the contents will be reread.

WINDOW.SELECTCONTENTS

This will select the contents of the drawer the command operates on.

WINDOW.CLEARSELECTION

This unselects all icons selected in the drawer the command operates on.

WINDOW.CLEANUPBY.COLUMN

This will sort the contents of the drawer and place the icons in columns.

WINDOW.CLEANUPBY.NAME

This will sort the contents of the drawer by name and place the icons in rows.

WINDOW.CLEANUPBY.DATE

This will sort the contents of the drawer by date and place the icons in rows.

WINDOW.CLEANUPBY.SIZE

This will sort the contents of the drawer by size and place the icons in rows.

WINDOW.CLEANUPBY.TYPE

This will sort the contents of the drawer by type and place the icons in rows.

WINDOW.RESIZETOFIT

This will resize the drawer window, trying to make it just as large as to allow all its icons to fit.

WINDOW.SNAPSHOT.WINDOW

This will snapshot the drawer window, but none of its contents.

WINDOW.SNAPSHOT.ALL

This will snapshot the drawer window and its contents.

WINDOW.SHOW.ONLYICONS

This will change the display mode of the drawer to show only files and drawers which have icons attached.

WINDOW.SHOW.ALLFILES

This will change the display mode of the drawer to show all files and drawers, regardless of whether they have icons attached or not.

WINDOW.VIEWBY.ICON

This will change the display mode of the drawer to show its contents as icons.

WINDOW.VIEWBY.NAME

This will change the display mode of the drawer to show its contents in textual format, sorted by name.

WINDOW.VIEWBY.DATE

This will change the display mode of the drawer to show its contents in textual format, sorted by date.

WINDOW.VIEWBY.SIZE

This will change the display mode of the drawer to show its contents in textual format, sorted by size.

WINDOW.VIEWBY.TYPE

This will change the display mode of the drawer to show its contents in textual format, sorted by type.

Top Previous Next Chapter