Select

The Select internal command is used to:

 

Command Arguments:

Argument

Type

Possible values

Description

(no arguments)

-

-

Displays the Select dialog (in either simple or advanced modes, depending on which was last used).

Example: Select

ADVANCED

/S

(no value)

Displays the Select dialog in advanced mode.

Example: Select ADVANCED

ALL

/S

(no value)

Select all files and folders in the current source file display.

Example: Select ALL

ALLDIRS

/S

(no value)

Select all folders in the current source file display.

Example: Select ALLDIRS

ALLFILES

/S

(no value)

Select all files in the current source file display.

Example: Select ALLFILES

DATE

/K

<date>

Select files whose last modification timestamps match the specified date. You can specify:

 

  • Just a date, in the format YYYY-MM-DD
  • Just a time, in the format HH:MM (seconds are ignored)
  • Both a date and time, in the format YYYY-MM-DD HH:MM

 

Note that specifying both a date and time requires quotes around the value, because of the space character separating the two.

You can also use > (greater than) before the date to match all files newer than the specified date, or < (less than) before the date to match all files older than the specified date.

You can also specify an age rather than a date to test for. For example, to select all files older than 5 days, you might specify Select DATE ">5 days". Valid keywords for age selection are day, week, month, year, hour, minute, second.

Example: Select *.jpg DATE ">2012-06-15 10:00"

 

 

 <date1>..<date2>

Select files whose last modification timestamps falls between the two specified dates. Both dates are supplied in the format described above.

Example: Select DATE 2012-01-01..2012-12-31 TYPE=files

 

 

 oldest

Select the oldest item in the current source file display. You can combine this with the PATTERN argument to select the oldest of a specific type of file.

Example: Select *.doc DATE=oldest

 

 

 newest

Select the newest item in the current file display.

Example: Select DATE=newest DESELECTNOMATCH

 

 

 created

Normally this command considers the last modification timestamp of each file, however by specifying this keyword you can make it look at the creation time instead.

Example: Select *.(zip|7z|rar) DATE=created,2010-03-10..2010-03-17

 

 

 both

Considers both created and last modification timestamps.

Example: Select DATE=both,newest

 

 

 next

Modifies the behavior of the newest and oldest arguments. Normally, Select DATE=newest would select the newest file in the list. If it were already selected, nothing would change. If you add the next keyword, Opus will progressively select the next newest file each time the command is run.

Example: Select DATE=next,newest

DESELECT

/S

(no value)

Instead of selecting files, the command will deselect them. This is used in conjunction with the PATTERN, ALLDIRS and ALLFILES arguments.

Example: Select *.jpg DESELECT

DESELECTNOMATCH

/S

(no value)

Files that don't match the pattern will be deselected (normally files that don't match are left alone).

Example: Select *.doc DESELECTNOMATCH

DESTTOSOURCE

/O

(no value)

Selects all files and folders in the source file display that are currently selected in the destination. The comparison is only done on the filename - the files are not actually compared.

Example: Select DESTTOSOURCE

 

 

noext

Does not consider file extensions when comparing selected files in the source and destination. For example, if IMGP1234.JPG was selected in the destination, and IMGP1234.WAV existed in the source, it would be selected.

Example: Select DESTTOSOURCE=noext

EXACT

/S

(no value)

Indicates that the PATTERN argument is a literal file name and not a wildcard or regular expression. This allows you to specify an exact filename without having to escape wildcard characters like '(' and ')'.

Example: Select "Cat Photo (1).jpg" EXACT

FILTER

/S

(no value)

Performs file selection using a pre-defined filter. The name of the filter must be given as the value of the PATTERN argument. Filters must have previously been configured through the File Operations / Filters page in Preferences.

Example: Select "Image Files" FILTER

FILTERFLAGS

/K

select

Select files that match the filter (this argument is used in conjunction with the FILTER argument). This is the default behaviour.

Example: Select Documents FILTER FILTERFLAGS=select

 

 

deselect

Deselect files that match the filter.

Example: Select "Music Files" FILTER FILTERFLAGS=deselect

 

 

hide

Hide files that match the filter.

Example: Select "Temp Files" FILTER FILTERFLAGS=hide

 

 

hidenomatch

Hide files that don't match the filter.

Example: Select "Image Files" FILTER FILTERFLAGS=hidenomatch

FIRST

/S

(no value)

Select the first item in the source file display, deselect all other items.

Example: Select FIRST

FROMCHECKS

/S

(no value)

Convert the state of checked items to selections (checked items will be selected, non-checked items will be deselected). This only applies in checkbox mode.

Example: Select FROMCHECKS

FROMSCRIPT

/S

(no value)

This command should be used when running a Select command from a script (e.g. via Command.RunCommand). It tells the command to select the files in the Command object itself.

Example:Func.Command.RunCommand("Select FROMSCRIPT");

HIDESEL

/S

(no value)

Hide all selected files. This is used either with the PATTERN argument to hide all files that match the pattern, or with the NOPATTERN argument to hide all currently selected files.

Example: Select *.tmp HIDESEL

HIDEUNAFFECTED

/S

(no value)

When used with the synchronize tool, this hides any items from the list that are not marked to be synchronized (either copied or deleted).

Example:Select HIDEUNAFFECTED

HIDEUNSEL

/S

(no value)

Hide all unselected items. This is used either with the PATTERN argument (files that don't match the pattern will be hidden), or with the NOPATTERN argument (all currently unselected files will be hidden).

Example: Select NOPATTERN HIDEUNSEL

INVERT

/S

(no value)

Inverts the selection state of all items in the source file display.

Example: Select INVERT

LAST

/S

(no value)

Selects the last item in the source file display, deselect all other items.

Example: Select LAST

MAKEVISIBLE

/S

(no value)

Ensures that the first selected item is visible in the file display. The list will be scrolled if needed. Similar to the SETFOCUS argument except the viewer pane will not update to show the new selection.

Example: Select *.doc MAKEVISIBLE

NEXT

/O

(no value)

Selects the next item in the file display. The first item immediately following the first currently selected item will be selected, and all other items deselected.

Example: Select NEXT

 

 

mark

Toggles the selection state of the currently focused item, and moves the input focus to the next item in the list. This is the equivalent of pressing the Insert key in the file display.

Example:Select NEXT=mark

NONE

/S

(no value)

Deselects all items in the source file display.

Example: Select NONE

NOPATTERN

/S

(no value)

The Select command normally requires a value for the PATTERN argument to operate, but in some cases you may need it to operate without supplying a pattern. For example, the HIDESEL and HIDEUNSEL arguments can be used to hide all currently selected or unselected items without applying a new wildcard selection first.

Example: Select HIDESEL NOPATTERN

PATTERN

 

<pattern>

Specify a wildcard pattern. All items matching the supplied pattern will be selected (or deselected, hidden, etc. based on the other arguments for this command). The pattern can be specified using standard pattern matching syntax, or regular expressions if the REGEXP argument is supplied. The PATTERN argument is also used to provide the name of a pre-defined filter in conjunction with the FILTER argument.

This is the default argument for the Select command and so the PATTERN keyword does not need to be supplied.

Example: Select *.(bmp|jpg|gif) HIDEUNSEL

PREV

/O

(no value)

Select the previous item in the file display. The first item immediately preceding the last currently selected item will be selected, and all other items deselected.

Example: Select PREV

 

 

mark

Toggles the selection state of the currently focused item, and moves the input focus to the previous item in the list. Similar to pressing the Insert key, except the focus moves to the previous rather than the next item.

Example:Select PREV=mark

RANGE

/K

<range>

Selects a range of items based on their index (their position in the list). This command is equivalent to the range selection mode of the find-as-you-type field. The <range> value consists of one or more comma-separated ranges; each range can be a single number, or two numbers separated by a hyphen to indicate all numbers within that range.

Example: Select RANGE 3,8-15,22-25,30

REGEXP

/S

(no value)

Use regular expression mode instead of standard pattern matching.

Example: Select .*\.jpg REGEXP

RESELECT

/S

(no value)

Reselects all files and folders that were used (and deselected) by the previously executed command.

Example: Select RESELECT

SETFOCUS

/S

(no value)

Ensures that the first selected item is visible in the file display. The list will be scrolled if needed. Additionally, if the viewer pane is open the first selected file will be automatically viewed if possible.

Example: Select *.jpg SETFOCUS

SHOWFOCUS

/S

(no value)

If necessary, scrolls the file display to make the currently focused item visible. The selection will not be modified.

Example:Select SHOWFOCUS

SHOWHIDDEN

/S

(no value)

Reveal any files or folders that have previously been hidden by commands using the HIDESEL or HIDEUNSEL arguments. The other way to reveal files hidden this way is by re-reading the folder (e.g. press F5).

Example: Select NOPATTERN SHOWHIDDEN

SHOWUNAFFECTED

/S

(no value)

When used with the synchronize tool, this reveals any items that have previously been hidden because they were not marked to be synchronized (either copied or deleted).

Example:Select SHOWUNAFFECTED

SIMILAR

/S

(no value)

Selects all files with the same file extensions as the currently selected files. For example, if a single .jpg and a single .gif file are currently selected, this command would select all .jpg and .gif files in the source file display.

Example: Select SIMILAR

SIMILARBASE

/S

(no value)

Selects all files with the same base-names as the currently selected files. For example, if cat.jpg and dog.gif are currently selected, this command would select all&nbap;cat.* and dog.* files in the source file display.

Example: Select SIMILARBASE

SIMPLE

/S

(no value)

Displays the Select dialog in simple mode.

Example: Select SIMPLE

SIZE

/K

<size>

Select files whose size matches the specified size. By default the size specified is treated as bytes, but you can use the following suffixes to use different units:

 

  • kb - kilobytes
  • mb - megabytes
  • gb - gigabytes

 

You can also use > (greater than) before the size to match all files larger than the specified size, or < (less than) before the size to match all files smaller than the specified size.

Example: Select *.png SIZE >2mb

 

 

 <size1>..<size2>

Select files whose size falls between the two specified sizes. Both sizes are supplied in the format described above.

Example: Select SIZE 500kb..5mb DESELECTNOMATCH

 

 

 largest

Select the largest item in the current source file display. You can combine this with the PATTERN argument to select the largest of a specific type of file.

Example: Select *.doc SIZE=largest

 

 

 smallest

Select the smallest item in the current file display.

Example: Select SIZE=smallest

SOURCETODEST

/O

(no value)

Selects all files and folders in the destination file display that are currently selected in the source. The comparison is only done on the filename - the files are not actually compared.

Example: Select SOURCETODEST

 

 

noext

Does not consider file extensions when comparing selected files in the source and destination. For example, if IMGP1234.JPG was selected in the source, and IMGP1234.WAV existed in the destination, it would be selected.

Example: Select SOURCETODEST=noext

THIS

/S

(no value)

Selects the current focus entry. It is possible for the entry with input focus to not be selected (for example, if you move the focus highlight with Control +Cursor-Down) and this command will select whichever entry is currently focused.

Example: Select THIS

TOCHECKS

/S

(no value)

Convert item selection states to check states. Selected items will be checked, and unselected items will be unchecked. If the file display is not currently in checkbox mode it will be turned on automatically.

Example: Select TOCHECKS

TYPE

/K

files

Force the selection to only affect files - even if folders match the pattern they will be unaffected.

Example: Select a* TYPE=files

 

 

dirs

Force the selection to only affect folders.

Example: Select "new *" TYPE=dirs