Introduction

Overview / Layout

Panels

FileSystem

File Operations

Extensions

Tools

Customization and Configuration

Configuring the Layout

User Commands and Scripting

Other

API

Troubleshooting

FAQ (pages to follow)

Index

MultiScript - Get and Set Selection and Paths

Functions for getting focus/selected files and folder from source/target views.

GetSelectedFileNames Get an array of all currently selected files in the source panel.
GetSelectedPaths Get an array with full paths of all currently selected files in the source panel.
GetSourceSelectedFileNames Get an array with the names of selected items in the source panel.
GetTargetSelectedFileNames Get an array with the names of selected items in the target panel.
GetSourceSelectedPaths Get an array with the full paths of the selected items in the source panel.
GetTargetSelectedPaths Get an array with the full paths of the selected items in the target panel.
GetSourcePath Get the current source path.
GetTargetPath Get the current target path.
GetSourceFocusPath Get the full path of the item in focus in the source panel.
GetTargetFocusPath Get the full path of the item in focus in the target panel.
GetSourceFocusName Get the name of the item in focus in the source panel.
GetTargetFocusName Get the name of the item in focus in the target panel.
GetSourceItems Get an array with all filenames or full paths of all items in the source panel.
GetTargetItems Get an array with all filenames or full paths of all items in the target panel.
SetSourceSelected Set selection in the source panel.
SetTargetSelected Set selection in the target panel.

GetSelectedFileNames

Get the filenames of all selected files/folders in the source view.

<arr> GetSelectedFileNames();

Return value

An array of all the names of the selected files and folders in the source view.

Example

@var $arr = GetSelectedFileNames();
LogDumpArray($arr);

GetSelectedPaths

Get the complete filepaths of all selected files/folders in the source view.

<arr> GetSelectedPaths();

Return value

An array of the complete paths for all the selected files and folders in the source view.

Example

@var $arr = GetSelectedPaths();
LogDumpArray($arr);

GetSourceSelectedFileNames

Get an array of the filenames of the selected items in the source view.

<arr> GetSourceSelectedFileNames([<str> flags]);

Parameters

flags

Optional, If not provided not flags are assumed
IGNORE_FOCUS - Ignore focus item if no items are selected, By default of no items are selected the item in focus is returned

Return value

An array of file names (names only - not complete paths).

Example

@var $arr = GetSourceSelectedFileNames();
LogDumpArray($arr);

@var $arr = GetSourceSelectedFileNames("IGNORE_FOCUS");
LogDumpArray($arr);

GetTargetSelectedFileNames

Get an array of all the filenames of the selected items in the target view.

<arr> GetTargetSelectedFileNames([<str> flags]);

Parameters

flags

Optional, If not provided not flags are assumed
IGNORE_FOCUS - Ignore focus item if no items are selected, By default of no items are selected the item in focus is returned

Return value

An array of file names (names only - not complete paths).

Example

@var $arr = GetTargetSelectedFileNames();
LogDumpArray($arr);

@var $arr = GetTargetSelectedFileNames("IGNORE_FOCUS");
LogDumpArray($arr);

GetSourceSelectedPaths

Get an array with the full paths of all selected items in the source view.

<arr> GetSourceSelectedPaths([<str> flags]);

Parameters

flags

Optional, If not provided not flags are assumed
IGNORE_FOCUS - Ignore focus item if no items are selected, By default of no items are selected the item in focus is returned

Return value

An array of full paths to files or folder.s

Example

@var $arr = GetSourceSelectedPaths();
LogDumpArray($arr);

@var $arr = GetSourceSelectedPaths("IGNORE_FOCUS");
LogDumpArray($arr);

GetTargetSelectedPaths

Get an array with the full paths of all selected items in the target view.

<arr> GetTargetSelectedPaths([<str> flags]);

Parameters

flags

Optional, If not provided not flags are assumed
IGNORE_FOCUS - Ignore focus item if no items are selected, By default of no items are selected the item in focus is returned

Return value

An array of full paths to files or folders.

Example

@var $arr = GetTargetSelectedPaths();
LogDumpArray($arr);

@var $arr = GetTargetSelectedPaths("IGNORE_FOCUS");
LogDumpArray($arr);

GetSourcePath

Get the complete path as currently shown in the source view.

<str> GetSourcePath();

Return value

A string with the complete path shown in the source view.

Example

@var $str = GetSourcePath();
// $str == "C:\MyFolder\";

GetTargetPath

Get the complete path as currently shown in the target view.

<str> GetTargetPath();

Return value

A string with the complete path shown in the target view.

Example

@var $str = GetTargetPath();
// $str == "C:\MyFolder\";

GetSourceFocusPath

Get the full path to the item in focus in the source view.

<str> GetSourceFocusPath();

Return value

A string with the full path to the item in focus

Example

@var $str = GetSourceFocusPath();
// $str == "C:\MyFolder\MyFile.txt";

GetTargetFocusPath

Get the full path to the item in focus in the target view.

<str> GetTargetFocusPath();

Return value

A string with the full path to the item in focus

Example

@var $str = GetTargetFocusPath();
// $str == "C:\MyFolder\MyFile.txt";

GetSourceFocusName

Get the name only of the item in focus in the source view.

<str> GetSourceFocusName();

Return value

A string with the name of the item in focus

Example

@var $str = GetSourceFocusName();
// $str == "MyFile.txt";

GetTargetFocusName

Get the name only of the item in focus in the target view.

<str> GetTargetFocusName();

Return value

A string with the name of the item in focus

Example

@var $str = GetTargetFocusName();
// $str == "MyFile.txt";

GetSourceItems

Get an array with all filename or fullpath of all the items in the source panel.

<arr> GetSourceItems([<num> fullpath]);

Parameters

fullpath

Optional. If provided and set to 1, it will return full filepaths, else only filenames are returned. If not set, 0 is assumed

Return value

An array with filename or path of all the items in the panel

Example

@var $arr = GetSourceItems();
// Full paths
@var $arr = GetSourceItems(1);

GetTargetItems

Get an array with all filename or full path of all the items in the target panel.

<arr> GetTargetItems([<num> fullpath]);

Parameters

fullpath

Optional. If provided and set to 1, it will return full filepaths, else only filenames are returned. If not set, 0 is assumed.

Return value

An array with filename or path of all the items in the panel

Example

@var $arr = GetTargetItems();
// Full paths
@var $arr = GetTargetItems(1);

SetSourceSelected

Set selection in the source panel

<int> SetSourceSelected(<arr> filenames, [<int> clear]);

Parameters

filenames

An array of filenames. The filenames will be used to match against the existing file in the view. and matched files will be selected.

clear

Optional. If provided and set to 1, the selections the in source view will be cleared before new selections are added
If set to 0, the new selections will be added to existing. If not set, 1 is assumed.

Return value

Number of files selected

Example

@var $arr[] = {"file1.txt", "file2.txt"};
@var $num = SetSourceSelected( $arr , 1);

SetTargetSelected

Set selection in the target panel

<int> SeTargetSelected(<arr> filenames, [<int> clear]);

Parameters

filenames

An array with strings of filename. The filename will be used to match against the existing file in the view. and matched files will be selected

clear

Optional. If provided and set to 1, the selections in the source view will be cleared before new selections are added
If set to 0, the new selections will be added to existing. If not set, 1 is assumed.

Return value

Number of files selected

Example

@var $arr[] = {"file1.txt", "file2.txt"};
@var $num = SetTargetSelected( $arr , 1);