Toolbar

The Toolbar internal command can be used to:

 

Command Arguments:

Argument

Type

Possible values

Description

CLOSE

/S

(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.

Example: Toolbar Operations CLOSE

If the toolbar was opened using the LOCAL argument then the LOCAL argument must also be used to close it.

Example: Toolbar Images CLOSE LOCAL

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: Toolbar NAME {f} IMPORT

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: Toolbar Operations LINE 1

 

 

<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: Toolbar Images LINE 1,500

LIST

/S

(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: Toolbar LIST

LOCAL

/S

(no value)

Opens a toolbar local to the current Lister. If this is specified the toolbar will open only in the currently active Lister - otherwise, the toolbar will be opened in all Listers.

Example: Toolbar Images LOCAL

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.

Example: Toolbar Images

 

 

*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: Toolbar CLOSE *this

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.

Example: Toolbar Applications STATE=float POS 1200,80

 

 

mouse

The floating toolbar will appear centered over the current position of the mouse pointer.

Example: Toolbar LauncherBar STATE=float POS=mouse

 

 

mousel

The floating toolbar is left-aligned with the position of the mouse pointer.

Example: Toolbar Images STATE=float POS=mousel TOGGLE

 

 

mouser

The floating toolbar is right-aligned with the mouse pointer.

Example: Toolbar Applications STATE=float POS=mouser

RESETDEFAULTS

/K

(no value)

Resets the toolbars to the 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: Toolbar RESETDEFAULTS

 

 

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: Toolbar RESETDEFAULTS=stateonly

 

 

quiet

Suppresses the confirmation prompt before resetting the toolbars.

Example: Toolbar RESETDEFAULTS=quiet

STATE

/K

top

Opens the specified toolbar at the top of the Lister. This is the default behaviour for this command.

Example: Toolbar Applications STATE=top

 

 

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: Toolbar Images STATE=bottom TOGGLE

 

 

left

Opens the toolbar at the left of the Lister. These toolbars appear vertically at the very left edge of the window.

Example: Toolbar Drives STATE=left

 

 

right

Opens the toolbar at the right of the Lister. These toolbars appear vertically at the very right edge of the window.

Example: Toolbar Drives STATE=right LINE=1 TOGGLE

 

 

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: Toolbar Drives STATE=center TOGGLE

 

 

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: Toolbar Applications STATE=viewpane

 

 

tree

Opens the toolbar between the left file display and the folder tree.

Example: Toolbar Drives STATE=tree

 

 

float

Floats the toolbar. You can specify the position of the floating toolbar with the POS argument.

Example: Toolbar Applications STATE=float TOGGLE

 

 

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: Toolbar Tools STATE=floatactive POS=0,0

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: Toolbar Operations TOGGLE LINE=1