The Toolbar internal command can be used to:
Command Arguments:
Argument |
Type |
Possible values |
Description |
---|---|---|---|
APPBAR |
/K |
left |
When opening a floating toolbar, specify this argument to dock the
toolbar with the left edge of the screen. Combine with
POS to control which monitor it docks
on. |
|
|
top |
Docks the toolbar with the top of the screen. |
|
|
right |
Docks the toolbar with the right of the
screen. |
|
|
bottom |
Docks the toolbar with the bottom of the
screen. |
|
|
off |
Undocks the toolbar if it is already docked. |
AUTOCLOSE |
/S |
(no value) |
Add this argument when opening a floating toolbar to make the toolbar
close automatically after running a command. This lets you have a toolbar
that can pop open (by key press for example), run a command and close
automatically again, and saves having to add the Toolbar
CLOSE=*this command to all the buttons on the
toolbar. |
CLOSE |
/O |
(no value) |
Closes the toolbar specified with the NAME argument.
Note that NAME is the default argument for this command,
the NAME keyword itself does not need to appear. The
toolbar will be closed only in the current Lister unless
LOCAL=no is also specified to close it
globally. |
|
|
all |
Closes all toolbars in the current Lister. |
FLOAT |
/O |
(no value) |
Opens the toolbar as a floating toolbar. This is the equivalent of
specifying STATE=float. Using the various arguments
provides more control over the floating toolbar. If combined with the
UPDATE argument you can make changes to already-open
toolbars. |
|
|
default |
Opens the floating toolbar with the default appearance. If not
specified (and no other arguments are specified), Opus will remember the
toolbar's settings from the last time it was
floated. |
|
|
active |
Activates the newly opened toolbar (equivalent to
STATE=floatactive). |
|
|
vertical |
Lay the floating toolbar out vertically instead of
horizontally. |
|
|
locked |
Lock the floating toolbar from being resized or
moved. |
|
|
autohide |
Set the floating toolbar to auto-hide when it is
docked. |
|
|
roundededges |
Display the toolbar with rounded edges. |
|
|
grid |
Make all buttons in the floating toolbar the same
size. |
|
|
frame |
Display the floating toolbar with a frame. |
|
|
noframe |
Display the floating toolbar with no frame. |
|
|
transparent |
Make the floating toolbar transparent. |
|
|
taskbar |
Display the floating toolbar with the system taskbar
theme. |
|
|
glass |
Display the floating toolbar using glass. |
|
|
topopus |
Set the floating toolbar to appear in top of other Opus
windows. |
|
|
toplevel |
Set the floating toolbar to appear on top of all other
windows. |
|
|
hotkeys |
Enable hotkeys in the floating toolbar. |
IMPORT |
/S |
(no value) |
Imports the toolbar specified with the NAME argument
into your Opus configuration. For this command, NAME must
specify the full path of the toolbar file to import. This would be most
useful on the context menu for .dop (toolbar)
files. |
LINE |
/K |
<line> |
When opening a toolbar, specifies the toolbar line it is to appear on.
The line number is given relative to the specified toolbar state. For
example, when STATE is bottom, the line given is relative
to the group of toolbars at the bottom of the Lister.
<line> is counted from
0. |
|
|
<line>,<position> |
Specifies both the line and the position of the new toolbar. This lets
you open a toolbar on the same line as an existing toolbar.
<position> is given as the number of pixels from the left
(or top, for vertical toolbars) edge of the Lister
window. |
LIST |
/O |
(no value) |
Displays a generated list of all your toolbars (acts as a dynamic button). This lets
you turn toolbars on or off from a drop-down
menu. |
|
|
sets |
Displays a list of toolbar
sets and lets you switch between them. |
|
|
add |
When a toolbar set is chosen from the generated list, it will be loaded
in "add" mode - meaning the toolbars within it will be added to any
currently open toolbars. This overrides the state of the option saved
within the set itself. |
|
|
replace |
When a toolbar set is chosen from the generated list, it will be loaded
in "replace" mode - meaning the toolbars within it will replace any
currently open toolbars. |
|
|
toggle |
When a toolbar set is chosen from the generated list, it will turn off
any previously loaded set, but leave the default toolbars unaffected.
Selecting the set again will turn it off. |
|
|
usekeys |
When a toolbar set is chosen from the generated list, Opus will check
the state of the Shift and Ctrl keys to
determine the behaviour. Holding the Shift key will
select "add" mode, and the Ctrl key will select "replace"
mode. |
|
|
nocontext |
Prevents the toolbar sets in the generated list from appearing
"checked" when Opus considers they are currently
active. |
LOADSET |
/O |
(no value) |
Loads the set specified by the NAME argument. The default behaviour
specified in the set ("add", "replace" or "toggle") will be used unless
overridden. |
|
|
add |
Adds the toolbars in the specified set to any currently open
toolbars. |
|
|
replace |
Replaces any currently open toolbars with those in the specified
set. |
|
|
toggle |
Turns off any previously loaded set, but leaves the default toolbars
unaffected. If the specified set is already open it will be closed (so
running the command twice has the effect of toggling the set on and
off). |
|
|
usekeys |
Uses the state of the Shift and Ctrl
keys to determine the behaviour when loading the set. Holding the
Shift key will select "add" mode, and the Ctrl
key will select "replace" mode. |
LOCAL |
/O |
(no value) |
Opens a toolbar local to the current Lister. Note that as this is the
default behaviour, specifying LOCAL or
LOCAL=yes has no
effect. |
|
|
no |
Opens the toolbar globally in all Listers. |
NAME |
|
<toolbar name> |
Specifies the name of the toolbar - used in conjunction with the other
arguments to open or close the specified toolbar. This is the default
argument for the Toolbar command and so the
NAME keyword does not need to be used. If no other
arguments to the command are provided, the named toolbar will be turned
on. |
|
|
*this |
Makes the command apply to the current toolbar. When used from a
toolbar button, the Toolbar command will apply to the toolbar the button
is contained within. |
POS |
/K |
<x>,<y> |
Specifies the on-screen position when opening a floating toolbar. The
position is given relative to the top-left corner of the primary display
monitor. This can also be used to control which monitor a docked toolbar
appears on (by combining it with the APPBAR
argument). |
|
|
mouse |
The floating toolbar will appear centered over the current position of
the mouse pointer. |
|
|
mousel |
The floating toolbar is left-aligned with the position of the mouse
pointer. |
|
|
mouser |
The floating toolbar is right-aligned with the mouse
pointer. |
RESETDEFAULTS |
/K |
(no value) |
Resets the toolbars to the factory defaults. All existing toolbars will
be closed, the default toolbars will be reset, and then only those
toolbars will be opened. |
|
|
stateonly |
Doesn't modify the toolbars themselves - instead, only the current set
of toolbars is reset to the defaults. Any toolbars you have created
yourself will be closed and the default set of toolbars displayed, but any
modifications you have made to the default toolbars will be
unaffected. |
|
|
quiet |
Suppresses the confirmation prompt before resetting the
toolbars. |
SAVESET |
/O |
(no value) |
Saves the current toolbars as a toolbar set. By default the new set will be
set to "replace" mode. Opus will prompt for a name for the set unless you
specify one with the NAME
argument. |
|
|
add |
Saves the toolbar set in "add" mode. |
|
|
toggle |
Saves the toolbar set in "toggle" mode. |
|
|
quiet |
Suppresses the confirmation prompt when saving over an existing toolbar
set. |
SETDEFAULT |
/O |
(no value) |
Saves the toolbars in the current Lister as the Default Toolbar
Set. |
|
|
quiet |
Suppresses the confirmation prompt before saving the
set. |
STATE |
/K |
top |
Opens the specified toolbar at the top of the Lister. This is the
default behaviour for this
command. |
|
|
bottom |
Opens the toolbar at the bottom of the Lister. These toolbars appear at
the very bottom of the window, underneath all other Lister
elements. |
|
|
left |
Opens the toolbar at the left of the Lister. These toolbars appear
vertically at the very left edge of the
window. |
|
|
right |
Opens the toolbar at the right of the Lister. These toolbars appear
vertically at the very right edge of the
window. |
|
|
center |
Opens the toolbar in the center of the Lister. These toolbars appear
between the two file displays in a dual-display Lister - they will be either
horizontal or vertical depending on the file display
arrangement. |
|
|
viewpane |
Opens the toolbar between the file displays and the viewer pane, when
the viewer pane is at the right of the Lister. If the viewer pane is not
open, or is at the bottom of the window, this value behaves the same as
right. |
|
|
tree |
Opens the toolbar between the left file display and the folder
tree. |
|
|
float |
Floats the toolbar. You can specify the position of the floating
toolbar with the POS
argument. |
|
|
floatactive |
Floats the toolbar and makes it active. This can be used to open a
toolbar and have it take input focus so you can open its drop-down menus
from the keyboard. |
|
|
fdb |
Changes which toolbar is used for the File Display
border. |
TOGGLE |
/S |
(no value) |
Toggles the toolbar specified with the NAME argument.
If the toolbar is not currently opened it will be opened, otherwise it
will be closed. |
UPDATE |
/S |
(no value) |
Updates an existing floating toolbar with new appearance and position
values. If the toolbar is not currently opened it will be opened using the
defined appearance. |