CreateFolder

The CreateFolder internal command is used to:

 

Command Arguments:

Argument

Type

Possible values

Description

ARCHIVE

/O

(no value)

Create a new archive file. The archive format will default to .zip but can be changed via the dialog.

Example: CreateFolder ARCHIVE

 

 

<archive format>

Create a new archive file of the specified format.

Example: CreateFolder ARCHIVE=.7z

ARCHIVEARGS

/K

<archive arguments>

Used to pass format-specific arguments when creating an archive. The format these arguments take is defined by the plugin and archive type in question - currently, none of the standard archive formats Opus supports make use of this.

Example: CreateFolder ARCHIVE=.moo ARCHIVEARGS="/compression=1"

COLLQUERY

/S

(no value)

Creates a a stored query collection rather than a regular file collection. This only has effect when actually creating a collection (because, for example, you are in the File Collections root folder at the time).

Example: CreateFolder COLLQUERY

FROMCLIPBOARD

/O

(no value)

Uses the text currently on the clipboard for the name of the new folder. Equivalent to CreateFolder "{clip}".

Example: CreateFolder FROMCLIPBOARD

 

 

multi

Creates multiple folders from the clipboard contents, assuming the clipboard contains multiple lines of CR/LF separated text. Without this keyword only the first line would be used.

Example: CreateFolder FROMCLIPBOARD=multi

INLINE

/S

(no value)

Creates a new folder and lets you edit its name inline (in the file display) - equivalent to selecting New -> Folder from the context or File menu.

Example: CreateFolder INLINE

NAME

/M

<folder name> ...

Specify the name of the folder or archive to create. If this argument is supplied Opus will not prompt for a name. You can specify a full path, or just the folder name to create the folder in the current source directory. You can also specify multiple names to create more than one folder at once. This is the default argument for the CreateFolder command, so the keyword NAME does not need to be specified.

Example: CreateFolder "Folder 1" "Folder 2" "Folder 3"

NOSEL

/S

(no value)

Normally when a folder is created in the currently displayed directory it is selected, and the display scrolled if necessary to make it visible. The NOSEL argument prevents this.

Example: CreateFolder "New Folder" NOSEL

NOUPDATESETTINGS

/S

(no value)

Prevents settings made by this command from becoming the new defaults. For example, if you specify the READAUTO argument, the value you provide will become the new default setting for the CreateFolder command unless you also specify NOUPDATESETTINGS.

Example: CreateFolder "{date|yyyyMMdd}" READAUTO NOUPDATESETTINGS

READAUTO

/O

(no value)

Automatically read the newly created folder into the current source file display.

Example: CreateFolder "New Folder" READAUTO

 

 

no

Do not automatically read the newly created folder.

Example: CreateFolder "New Folder" READAUTO=no

 

 

dual

Read the newly created folder into the other file display. If the Lister is not currently in dual-display mode it will be placed in this mode first. You can combine this value with tab to open a new tab in the other file display.

Example: CreateFolder "New Folder" READAUTO=dual

 

 

tab

Create a new tab for the newly created folder. The tab will be opened in the source file display unless dual is also specified.

Example: CreateFolder "New Folder" READAUTO=dual,tab

 

 

nofocus

When opening a new tab, prevents that tab from being made the active one.

Example: CreateFolder "New Folder" READAUTO=tab,nofocus

ZIP

/S

(no value)

Create a new Zip file (equivalent to CreateFolder ARCHIVE=.zip).

Example: CreateFolder ZIP