Toolbar
The Toolbar internal command can be used to:
Open or close toolbars or toolbar sets
Open or close a floating toolbar, control its appearance and position on screen
Save a new set or modify the Default Toolbar Set
Import a toolbar into your configuration
Reset your toolbars to the defaults
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. Example: |
top | Docks the toolbar with the top of the screen. Example: | ||
right | Docks the toolbar with the right of the screen. Example: | ||
bottom | Docks the toolbar with the bottom of the screen. Example: | ||
off | Undocks the toolbar if it is already docked. Example: | ||
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 Example: |
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. Example: |
all | Closes all toolbars in the current Lister. Example: | ||
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. Example: |
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. Example: | ||
active | Activates the newly opened toolbar (equivalent to STATE=floatactive). Example: | ||
vertical | Lay the floating toolbar out vertically instead of horizontally. Example: | ||
**locked ** | Lock the floating toolbar from being resized or moved. Example: | ||
autohide | Set the floating toolbar to auto-hide when it is docked. Example: | ||
roundededges | Display the toolbar with rounded edges. Example: | ||
grid | Make all buttons in the floating toolbar the same size. Example: | ||
frame | Display the floating toolbar with a frame. Example: | ||
noframe | Display the floating toolbar with no frame. Example: | ||
transparent | Make the floating toolbar transparent. Example: | ||
taskbar | Display the floating toolbar with the system taskbar theme. Example: | ||
glass | Display the floating toolbar using glass. Example: | ||
topopus | Set the floating toolbar to appear in top of other Opus windows. Example: | ||
toplevel | Set the floating toolbar to appear on top of all other windows. Example: | ||
hotkeys | Enable hotkeys in the floating toolbar. Example: | ||
HEADING | /O | (no value) | When used with commands which generate a list of items (see dynamic buttons), the HEADING argument adds a small heading at the start of the list. The heading will be hidden when the list is empty. Headings only happen for commands which potentially generate multiple items at the same level as the button itself. When HEADING is used by itself, without specifying a text value, the main button's label text is used for the heading. Example: |
<heading text> | You can specify the heading text if you want it to be different to the button's label. Example: | ||
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. Example: |
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. Example: |
<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. Example: | ||
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. Example: |
sets | Displays a list of toolbar sets and lets you switch between them. Example: | ||
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. Example: | ||
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. Example: | ||
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. Example: | ||
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. Example: | ||
nocontext | Prevents the toolbar sets in the generated list from appearing "checked" when Opus considers they are currently active. Example: | ||
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. Example: |
add | Adds the toolbars in the specified set to any currently open toolbars. Example: | ||
replace | Replaces any currently open toolbars with those in the specified set. Example: | ||
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). Example: | ||
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. Example: | ||
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. Example: |
no | Opens the toolbar globally in all Listers. Example: | ||
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, although it is still a good idea to do so. If no other arguments to the command are provided, the named toolbar will be turned on. Example: | |
*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. Example: | ||
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). Example: |
mouse | The floating toolbar will appear centered over the current position of the mouse pointer. Example: | ||
mousel | The floating toolbar is left-aligned with the position of the mouse pointer. Example: | ||
mouser | The floating toolbar is right-aligned with the mouse pointer. Example: | ||
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. If you have made changes to the default toolbars those changes will be lost, but none of your other toolbars will be affected (other than being turned off if they were open when the command was run). Example: |
fdb | Resets the Location Bar toolbar to its defaults. Use this in conjunction with nolister to only reset the location bar. Note that if neither the stateonly nor nolister arguments are provided, then fdb is implied (i.e. Example: | ||
nolister | By default all Lister toolbars are reset; use this in conjunction with fdb and viewer to only reset those toolbars. Example: | ||
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. Example: | ||
quiet | Suppresses the confirmation prompt before resetting the toolbars. Example: | ||
viewer | Resets the Image Viewer toolbar to its defaults. Use this in conjunction with nolister to only reset the viewer toolbar. Example: | ||
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. Example: |
add | Saves the toolbar set in "add" mode. Example: | ||
toggle | Saves the toolbar set in "toggle" mode. Example: | ||
quiet | Suppresses the confirmation prompt when saving over an existing toolbar set. Example: | ||
SETDEFAULT | /O | (no value) | Saves the toolbars in the current Lister as the Default Toolbar Set. Example: |
quiet | Suppresses the confirmation prompt before saving the set. Example: | ||
STATE | /K | top | Opens the specified toolbar at the top of the Lister. This is the default behaviour for this command. Example: |
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. Example: | ||
fdbottom | Opens the toolbar at the bottom of the file display(s). Similar to bottom but will not extend left under the leftmost folder tree. Example: | ||
left | Opens the toolbar at the left of the Lister. These toolbars appear vertically at the very left edge of the window. Example: | ||
right | Opens the toolbar at the right of the Lister. These toolbars appear vertically at the very right edge of the window. Example: | ||
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. Example: | ||
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. Example: | ||
tree | Opens the toolbar between the left file display and the folder tree. Example: | ||
float | Floats the toolbar. You can specify the position of the floating toolbar with the POS argument. Example: | ||
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. Example: | ||
fdb | Changes which toolbar is used for the File Display border. Example: | ||
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. Example: |
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. Example: |
最后更新于