Properties

The Properties internal command can be used to:

 

Command Arguments:

Argument

Type

Possible values

Description

(no argument)

-

-

Display the system Properties dialog for selected files and folders.

Example: Properties

ADDLABEL

/O

(no value)

In conjunction with the SETLABEL argument, this lets you add one or more labels without clearing any existing ones.

Example: Properties SETLABEL=Green ADDLABEL

Can be combined with SETLABELTOGGLE to toggle a single label.

Example: Properties SETLABEL=Bold ADDLABEL SETLABELTOGGLE

 

 

shift
ctrl
alt

If a keyword is specified, the labels will only be added if the specified key is held down when the function is run - otherwise the ADDLABEL argument will be ignored and they will replace existing labels as normal.
 

Example: Properties SETLABEL red ADDLABEL=ctrl

FILE

 

<filename>

Specifies the filename rather than using selected files. This is the default argument for the Properties command so you do not need to specify the FILE keyword. If the filename includes spaces make sure you enclose it in quotes.

Example: Properties "C:\Windows\System32\notepad.exe"

FOLDEROPTIONS

/S

(no value)

Display the Folder Options dialog for the current folder.

Example: Properties FOLDEROPTIONS

FORMATLIST

/O

(no value)

Displays a generated list of your favorite and content type folder formats (acts as a dynamic button). This displays one item for each format saved in the Favorite Formats category on the Folder Formats page in Preferences. Selecting a format from the generated list applies its settings to the current file display.

Example: Properties FORMATLIST

 

 

favorites

Only displays favorite formats (omits those for content types).
 

Example: Properties FORMATLIST=favorites

 

 

contenttype

Only displays content type formats (omits those for favorites).
 

Example: Properties FORMATLIST=contenttype 

 

 

noreset

Prevents the addition of the "reset" commands which are normally generated at the end of the format list (e.g. Reset to Defaults).
 

Example: Properties FORMATLIST=favorites,noreset

FTPSITE

/S

(no value)

Display the FTP Site Properties dialog for the currently connected FTP site. If you are not currently viewing an FTP directory this command has no effect.

Example: Properties FTPSITE

LABELCATEGORY

/K

<category>

When used on a command that generates a list of labels (e.g. Properties SETLABEL or Properties SETLABEL !menu) this argument lets you filter the generated list by category. It accepts one or more comma-separated wildcard strings which let you match the name of categories to include.


The specified categories will also be used when resetting labels using the Properties SETLABEL !reset command - if LABELCATEGORY is used as well, only labels in the specified categories will be cleared. This is used in the default Properties drop-down menu to provide a command that clears status icons without affecting other labels.
 

You can match uncategorized labels using the pattern ~* (which means "not anything").

 

Special handling exists for the two predefined categories, Status and Colors; these can be referenced using the English names prefixed with raw: and will work in any language.
 

Example: Properties SETLABEL !menu LABELCATEGORY raw:~(Status)

LISTER

/S

(no value)

Displays the system Properties dialog for the folder currently displayed in the source file display.

Example: Properties LISTER

NOFROMFOCUS

/S

(no value)

The default behaviour for the Properties command is to operate on either the source file display, or the Folder Tree, depending on which one has the input focus. This lets you use the same command to access the Properties dialog for folders in the tree as well as files and folders in the file display. Specify this argument to force the command to always operate on the source file display and ignore the folder tree.

Example: Properties NOFROMFOCUS

SETLABEL

/O

(no value)

Displays a generated list of your configured labels (acts as a dynamic button). Selecting a label from this list applies it to all selected files and folders.
 

This command supports embedded functions when it's used to generate dynamic  buttons.

Example: Properties SETLABEL

 

 

<label>[,<label>,...]

Applies the specified label or labels to all selected files and folders. Multiple label names must be comma-separated. Commas and back-slashes in label names must be escaped with a back-slash.

 

You can combine this with the ADDLABEL argument to add labels to existing ones rather than replacing them. You can further combine it with SETLABELTOGGLE to toggle labels on and off.

The keyword stoponmatch can be used to add the "stop on match" flag to a file, which prevents any wildcard or label filters from applying to the file.

Example: Properties SETLABEL=Green,Blue

 

 

!menu

Places the generated label list inside a menu.
 

Example: Properties SETLABEL !menu

 

 

!submenu

Generates submenus for each label category.
 

Example: Properties SETLABEL !submenu

 

 

!submenu2 

Generates submenus for each label category, and places labels without a category in an Uncategorized group.
 

Example: Properties SETLABEL !menu,!submenu2

 

 

!nogroup

Labels are grouped by category by default; specify !nogroup to ignore categories and generate a flat list of labels, sorted only by name, with labels from different categories intermingling.
 

Example: Properties SETLABEL !menu,!nogroup

 

 

!noreset

After automatically generated lists of labels, a Reset option is normally added. You can prevent this by specifying !noreset.
 

Example: Properties SETLABEL !noreset

 

 

!nostoponmatch

After automatically generated lists of labels, a Stop On Match option is normally added, if multiple labels matching a single file is enabled in Preferences. You can prevent it being added by specifying !nostoponmatch.
 

Example: Properties SETLABEL !nostoponmatch,!noreset LABELCATEGORY raw:Status

The example above would give you top-level buttons, directly on the toolbar, to toggle each of the Status labels, with no extra buttons cluttering up the toolbar.

 

 

!reset

Removes the label from all selected items. You can combine this with the LABELCATEGORY argument to only remove labels in certain categories.

Example: Properties SETLABEL=!reset

SETLABELINFS

/K

yes

Specify in conjunction with the SETLABEL argument to override the state of the Preferences / Favorites and Recent / File and Folder Labels / Automatically store labels in the file system if possible option. Labels will be stored in the file system even if that option is disabled.

Example: Properties SETLABEL=Green SETLABELINFS=yes

 

 

no

The labels will be stored in your Opus configuration.

Example: Properties SETLABEL=Blue SETLABELINFS=no

SETLABELREMOVE

/O

(no value)

Specify in conjunction with the SETLABEL argument to remove labels. If the targeted file or folder already has the specified label, the label will be removed. Otherwise nothing will happen.

(Only affects labels explicitly applied to individual folders and files. Labels picked up via wildcards and filters can be overridden by more explicit labels but cannot be toggled on individual items.)

Example: Properties SETLABEL=Bold SETLABELREMOVE

 

 

shift
ctrl
alt

If specified, the SETLABELREMOVE argument will only apply if the specified key is held down when the function is run.
 

Example: Properties SETLABEL=Bold SETLABELREMOVE=alt

SETLABELTOGGLE

/O

(no value)

Specify in conjunction with the SETLABEL argument to toggle labels. If the targeted file or folder already has the specified label, the entire label will be cleared instead.

(Only affects labels explicitly applied to individual folders and files. Labels picked up via wildcards and filters can be overridden by more explicit labels but cannot be toggled on individual items.)

Example: Properties SETLABEL=Bold SETLABELTOGGLE

Combine with ADDLABEL to toggle only a single label, while leaving any other labels the file has alone.

Example: Properties SETLABEL=Red SETLABELTOGGLE ADDLABEL

 

 

shift
ctrl
alt

If specified, the SETLABELTOGGLE argument will only apply if the specified key is held down when the function is run. If the key isn't held down, the label will only be turned on - it won't be toggled off again.
 

Example: Properties SETLABEL=Bold SETLABELTOGGLE=shift

SETWALLPAPER

/O

(no value)

Sets the selected image file as the system wallpaper. Opus will make a copy of the selected image file (and convert its format if necessary) - you can change where the copy is stored with the setwallpaper_file option on the Miscellaneous / Advanced page in Preferences.

Example: Properties SETWALLPAPER 

 

 

center

The wallpaper mode will be set to center the image on screen.

Example: Properties SETWALLPAPER=center

 

 

tile

The image will be tiled across the screen.

Example: Properties SETWALLPAPER=tile

 

 

stretch

The image will be stretched (or shrunk) to fill the screen completely.

Example: Properties SETWALLPAPER stretch

 

 

fit

The image will be cropped if necessary to fill the screen. The aspect ratio of the image will be preserved. This is only available on Windows 7 and above.

Example: Properties SETWALLPAPER=fit

 

 

fill

The image will be stretched or shrunk to fill screen, but the aspect ratio will be preserved - and so black bars may be displayed on the sides or top and bottom of the image. This is only available on Windows 7 and above.

Example: Properties SETWALLPAPER fill

 

 

span

The image will be spanned across a multiple monitor desktop. This is only available on Windows 8 and above.
 

Example: Properties SETWALLPAPER span

 

 

menu

Displays a drop-down menu of the various wallpaper modes (acts as a dynamic button). Selecting a mode from this menu sets the selected image file as the wallpaper using that mode. This is useful when added to the context menu for the Images file type group.

Example: Properties SETWALLPAPER=menu

SINGLE

/S

(no value)

Modifies the behaviour of the Properties command when more than one file or folder is selected. By default a combined Properties dialog is shown for all selected items, but if SINGLE is specified an individual Properties dialog is shown for each item.

Example: Properties SINGLE