Change Log for the latest
XYplorer BETA version:
Code: Select all
v15.60.0005 - 2015-08-24 17:14
* SC FlattenFolder: Completely redesigned, bug-fixed, and enhanced.
Undo/Redo is now supported! Watch out for the new order and type of
arguments!
Name: FlattenFolder
Action: Flattens a folder.
Syntax: flattenfolder([folder], [flags="s"], [separator_name="-"], [separator_return=CRLF])
folder: (optional) Folder to flatten.
If missing then:
If List has focus and a folder is focused in List, then
this folder is flattened.
Else: Defaults to the current folder.
flags: (in any order)
s: [default] Pop safety prompt.
m: Return name mappings: old > new (else just new names are returned).
p: Preview only: Just return names/mappings, no actual flattening.
f: Prefix folder names to file names: Maps the folder structure
to the filenames. Advantage: Avoids any collisions and keeps
the information with the files. Disadvantage: Names can get long.
separator_name: Separates the folder names in the filename if flag "f" is passed.
Defaults to "-".
separator_return: Separates the items in the return value.
Defaults to CRLF.
return: List of contents of the folder after being flattened; items with
full path, separated by separator.
On flag "m", name mappings are returned (see above).
Remarks:
- The function will auto-avoid filename collisions by affixing
increments to the new name according to the user settings
(Configuration | Templates | Filename Affixes).
- Undo/Redo is supported.
- The tags database is updated for the moved items.
- Warning: This command can easily destroy a complex folder structure.
Therefore a safety prompt has to be OK-ed before the rumble begins
(unless you overwrite the default flag "s").
Examples:
flattenfolder(); //flatten current folder, safety prompt
flattenfolder(, ""); //same, but without prompt
text flattenfolder(); //flatten and show return
text flattenfolder(, "mp"); //just show return (name mappings), no flattening
// flatten this folder, prefix folder names separated by "+", show prompt:
flattenfolder("E:\Test\flatten-01", "sf", "+");
! Interface Translation Tool: Drawing glitches on high contrast themes. Fixed.
To
download the latest BETA version choose a download package: (1)
Installer Package, (2)
No-Install Package.
Note that BETA versions are work in progress and might contain fresh bugs. You have been warned.
It's a good idea to backup your complete XYplorer settings (menu File | Settings Special | Backup Application Data Folder...)
before running a new BETA version. This will also help in fixing any fresh bugs.