Address Bar

(3)

It optionally auto-completes recently used items: When you start typing a location into the address bar, it shows you a list of places (sorted alphabetically, §colored green) you've gone to before that match what you've typed so far. To see the complete list sorted alphabetically, empty the edit field, hold CTRL, and press the down or up arrow key.

Down/Up:

§Open MRU list.

Ctrl+Down/Up:

§Open the auto-complete match list. Any selection in the edit field is removed and the caret is placed at the right end of the contents.
If the edit box is empty the whole MRU list is shown as Match List, i.e. sorted alphabetically.

·	The tree will be the last saved Mini Tree, and cannot be turned to a Maxi Tree.

·	It is locked and the expansion state is locked, both cannot be unlocked.

·	You cannot drag anything from the tree.

·	You cannot rename anything in the tree.

·	View \| Mini Tree \| - submenu - is gone.

·	Tools \| List Management \| Mini Tree... is gone.

·	Tree changing commands like "Hide Folder from Mini Tree" or "Flatten Folder" are

· m.dot

§not available anymore.

·	The "Mini Tree" toolbar button is gone.

·	SC button "minitree" does not work anymore.

·	SC loadtree does not work anymore.

·	IFilters are not used when either "It's a hex string" or "§Match unicode" are ticked.

·	It depends on your system which IFilters are available. In the web you can find IFilters for almost anything.

·	Where IFilters fail for whatever reason the logic falls back to binary search and checks the raw bytes for contents.

.*	Hide all items beginning with a dot.

desktop.ini

Hide all items called "desktop.ini".

·	Toggle the box: "Window \| Show Live Filter Box".

·	Show the box to the left of the Status Bar: tick Window \| Arrangement \| Live Filter Box in Status Bar. Note that if the Address Bar is hidden then the LFB automatically goes to the Status Bar.

·	Syntactically and functionally it's identical to Visual Filters, so you have all the power and need not learn anything new about patterns. Of course, Regular Expressions are supported as well.

·	Contrary to normal Visual Filters, however, the Live Filters are transient: They don't persist between location changes, tab switches, or sessions (but they are internally remembered per tab so you can toggle them back on, see below).

·	Each tab internally remembers its last used filter even across sessions.

·	Toggle the filter using "View \| Tab \| Toggle Live Filter" (Ctrl+Alt+F3).

·	Although it's a filter the box icon is the classic §loupe symbol, the de facto standard in such a box. Not a problem, after all a filter is nothing but a non-recursive search.

·	When the LFB is shown it gets the focus, when it's hidden any live filter is removed from the list.

·	When the LFB is shown and the focus is in the list (single pane), §press TAB to move the focus to the LFB.

·	Pressing ESC in a filled box clears the filter. If Redirect typing to Live Filter Box is enabled then it §will also hide the box.

·	Pressing ESC in an empty box sets the focus to the list. So you can jump in and out of the box by TAB and ESC. If Redirect typing to Live Filter Box is enabled §then it will hide the box.

·	When the filter is removed, the last scroll position of the unfiltered list is restored (it's even remembered across tab switches and sessions). Exception: If an item is focused AND selected at the moment the filter is removed, that item will be scrolled into view.

·	Hiding the LFB will automatically clear any filter.

·	When a live filter is active the filter information is shown in the list if this is ticked (highly recommended): "Configuration \| Filters & Type Ahead Find \| Visual Filters \| Show filter information in list". The bar has a right-click menu.

·	Dbl-click the filter information bar in the list to remove the live filter quickly.

·	Keys Up, Down, PageUp, PageDown work to move the focus within the list.

·	The Backspace key can be used §right from the LFB if it is mapped to "Go \| Up" (by default Backspace) or "Go \| Down" (by default Shift+Backspace) AND if the LFB is empty.

·	Ctrl+Backspace will remove the last word in the LFB.

·	Hitting Enter on a folder navigates into the folder and resets the live filter back to nothing.

·	Hitting Enter on a file runs the file and doesn't reset the live filter.

·	Hitting Enter even works on the focused item even if it is not selected. In that case the focused item is auto-selected before processing continues. Saves a key stroke in some situations.

·	Pressing any character key will append it to the current filter. The box is shown if not yet visible.

·	Pressing §Back will remove the last character of the current filter.

·	Pressing ESC will remove the filter §and the box if there is any.

·	The items are sorted by path/name ascending.

·	The items can be live-filtered to quickly find a particular file in an archive.

·	Encrypted archives are marked as such in the top section of the dialog, and with a "+" behind the filenames.

·	You cannot extract from or add to the zip via this interface, it's merely a view.

·	The dialog shares size and position with the Quick File View.

·	If you opened the preview by F11 you can also close it by F11 (or whatever other KS you have assigned to Floating Preview).

·	The dialog is non-modal, so you can leave it open and preview Zip archives by simply selecting them in the file list.

(1)	select any number of files

(2)	right-drag them somewhere

(3)	click "Move (Copy) Here to New Subfolder..." in context menu

(4)	dialog opens, enter new folder name, click OK

(5)	this folder is now created under the dragged-to folder...

(6)	... and the selected files are moved (copied) into it

condition

If True the script is ended else nothing happens
(True = anything but 0 or empty)

message

message before ending

0 = [default] end whole script stack

linebreaker

Any character sequence to be replaced by a line break.
Defaults to "<br>".
Pass "" to prevent any replacing.

"list_history", §[separator=CRLF], [tab_index]
[separator]: String to place between items. Defaults to CRLF (line feed).
flags: Defaults to "fc".
tab_index: Tab index (first tab = 0) for a tab-specific history. If missing then the global history of the pane is returned.
return: List of historical locations (identical to menu Go | History), ordered in backward chronology from latest to earliest. The current position in history is ignored.
Examples:
text get("list_history"); //global history of the current pane
text get("list_history", , 1); //history of the 2nd tab of the current pane

-	"list_recentlocations", [separator=CRLF] ----

"Path", [pane=a]
Returns the unslashed path (see note below) of any of the two panes.
For the optional "pane" argument see "BytesSelected" above.
Example: echo get("path", i); //inactive pane's path

Note on returning unslashed paths: "C:" and "C:\" do not necessarily point to the same location according to Microsoft:
If a file name begins with only a disk designator but not the backslash after the colon, it is interpreted as a relative path to the current directory on the drive with the specified letter. Note that the current directory may or may not be the root directory depending on what it was set to during the most recent "change directory" operation on that disk. §Examples of this format are as follows:
"C:tmp.txt" refers to a file named "tmp.txt" in the current directory on drive C.
"C:tempdir\tmp.txt" refers to a file in a subdirectory to the current directory on drive C.

property()

Retrieves a particular property from a file or folder.

Let XYplorer find the Property Index

Prefix an asterisk (*) to the property name and it is internally resolved to the matching index. The name can be any of the items listed in Configuration | File Info Tips & Hover Box | §Show custom file info tips. Note that the name is localized (but not case-sensitive), so in a German Windows you would do this to retrieve the width of an image file...

text property("*breite");

... and this in an English Windows:

text property("*width");

Note that spaces in property names must be passed as underscores:

text property("*Letzter_Zugriff");

------------------------

Metadata (aka Extended Properties)

The so-called "Extended Properties" (the complete set of available metadata of file) are fully supported using the field {prop:[property]}. [property] can be a numeric as well as a literal property identifier.

For example, the following line reports the image dimensions for image files in the current list using the literal property identifier "dimensions":

text report("{name} ({prop:dimensions})<crlf>");

This line yields the same results in a different way:

text report("{name} ({prop:ImageX} x {prop:ImageY})<crlf>");

This line yields the same results in yet another way, namely with numeric property identifiers (note that these numbers only work in Win7!) :

text report("{name} ({prop:#162} x {prop:#164})<crlf>");

Note that MS made a total mess here so that each Windows version has a completely reshuffled set of numbers and keywords. But there is help: The line numbers in "Configuration | File Info Tips & Hover Box | §Show custom file info tips" give you the actual values of all available extended properties in your current Windows version. Literal property identifiers are not documented at all by MS, so you can only guess, trial, and error.

----------------------------------

Extended Syntax for "Soft Columns"

The comma-separated list of canonic column names also supports the extended possibilities that XYplorer also uses internally. You can directly create and show new custom columns, even with custom captions, by means of the "columns" argument.

These on-the-fly Custom Columns are called "Soft Columns" to distinguish them from the "hard" Custom Columns "Custom 1" to "§Custom 5". There are 4 types of Soft Columns:

[caption]:n-10 = numeric shell property #10

[caption]:v-dimensions = verbal shell property "dimensions"

[caption]:s-audio.bitrate = special property "audio.bitrate"

[caption]:d-10 = definition of Custom Column 10

^ Optional caption; if missing then an automatic caption is coined

depending on the contents of the column.

^ Prefix n, v, s, or d, separated with a "-" just for better

readability. The prefix determines the type of the column.

^ Content definition, depending on the type.

^ What this column would display.

--------------------------

Styles

Remember list settings per tab

Here you can control which list settings are remembered tabwise, and which are applied (inherited) cross-tab. The button "Apply to..." allows you to further refine which list properties you want to retain per tab.

The factory default is to §remember them all.

For example, if you would like to have the same sort order in all tabs, but keep the view mode (Details, Thumbnails...) persistent in each tab, then you would check Remember list settings per tab, and then in the list under the "Apply to..." button you would check "View Mode" and uncheck "Sort Order".

·	Left-clicking an item does not select this item and unselect all others. Instead it moves the focus to the item, and displays it in the Info Panel, even if it's not selected.

·	To select/unselect an item you have to click the checkbox. Or start a lasso select by dragging the mouse with the left button held down.

·	Left-clicking the empty List space does not unselect anything.

·	Moving the focus via arrow keys does not change any selections.

·	Space key toggles the selection of the focused item (§no need to hold CTRL).

·	Right-clicking an item focuses and selects it (but leaves any other selections unchanged), then pops the context menu for all selected items.

·	No slow double-click rename.

----------------

Minimum / Maximum Name column width: Here you can specify the minimum and the maximum width (in pixels) for the Name column when "Autofit the width of the Name column" is enabled. Factory default for the minimum is §175 pixels. For the maximum it's 0 (zero), which means: there is no maximum.

-------------------

Copy tags on §backup operations

If enabled then tags are copied from the source to the target items of backup operations and of sync folder operations.

-------------------

File Operations

----------

Background Processing

Enable background processing

Check to launch file operations in a separate process.

The advantage of background processing: You can continue working in XYplorer while heavy copy jobs are processed in the background.

Technically this is achieved by passing the file operations to the copy handler XYcopy (XYcopy.exe) which is contained in the distribution package and must be located in the same folder as XYplorer.exe.

Apply To...

Click the button "Apply to..." to configure which types of file operations are backgrounded. The factory default is:

[x] Backup (can be queued)

[x] Copy (can be queued)

[x] Move cross-volume (can be queued)

[ ] Move intra-volume (runs at once in parallel process)

[ ] Delete (runs at once in parallel process)

§[ ] Sync Folders (can be queued)

-----------------------

Thumbnails

--------------------

§Show file icon on thumbnail

Check to show the small file icon in the top-left corner of the thumbnail.

----------------------

Choose which tab is selected when the current tab is closed:

·	Activate the right tab

·	Activate the left tab

·	Activate the last used tab

·	Activate the default tab If there is no default tab defined it will fall back to "Activate the right tab".

Cycle tabs in recently used order

Check to cycle the tabs based on the usage sequence (aka MRU) instead of the left-to-right position.

The cycle functions are these (as listed in Customize Keyboard Shortcuts):

Miscellaneous / Tab Functions /

Cycle Tabs Backward: Ctrl+Shift+Tab; MouseWheel Up

Cycle Tabs Forward: Ctrl+Tab; MouseWheel Down

Cycle Tabs Backward, Delay Browsing: Ctrl+PageUp

Cycle Tabs Forward, Delay Browsing: Ctrl+PageDown

Note that going by MRU has the usual "history" logic: If you go backward from A to B, then to return to A you have to go *forward* (not backward again).

Note that when you are on the most recent tab, Ctrl+Tab will not wrap around but go backward. This allows you to §jump back and forth between the 2 most recent tabs with one key combination.

Note that with "Activate left tab on closing current" and "Cycle tabs in recently used order" both enabled, the *previously used tab* is auto-selected on closing the current tab.

[idh_status.htm] Status Bar

Status Bar

Sections of the Status Bar

Objects/Files Found

Displays the number of objects currently listed in List. In Browse mode this is the number of objects within the current folder, in Find mode the number of objects found.

Bytes

Displays the bytes sum of all currently selected items in List. If nothing is selected, the bytes sum of all items is shown.

Name/Progress

Displays the icon and name of the currently focused item (file or folder). By double-clicking these items you §can copy them to the clipboard.

Version in the Status Bar: Tick Configuration | Controls & More | Miscellaneous | Show version information in the Status Bar to show the embedded version information of executables, DLLs, DRVs, etc. (if they have any) right in the Status Bar on selecting such a file.

If nothing is selected, the used and free bytes of the current drive are shown.

During File Find the same section gives you feedback on the progress of the search by displaying the name of the currently searched location. When the find is finished, the used time is shown, and the number of files scanned (this is the number of all files that match at least the Name filter of the search).