Unicode Adapter

Unicode Adapter

Unicode Adapter is a workaround for the fact that ZTreeWin v1.x was not a Unicode-enabled application, and so can't access files whose names contain characters not available in the system's OEM or ANSI sets.
Note that ZTreeWin v2 is fully unicode-enabled, so the Unicode Adapter is not necessary anymore for it!

Usage

The tool can be called from ZTreeWin, passing along the name of a file which ZTreeWin can't access, and optionally a command to launch the file with.
UnicodeAdapter will attempt to find the Unicode name of the file ZTreeWin is referring to, and run the specified command, or if no command is specified, displays the file's context menu.

Syntax:

UnicodeAdapter drive:\path\filename [/cmd command]

drive:\path\filename    The full path to the file (ZTreeWin's %1). Quotes are accepted but not required.
command                 The command to run the file with.
                        This command string may contain the replacement tokens %1 and %7, which
                        correspond respectively to the full file name and the short file name,
                        in analogy to ZTreeWin. (Make certain to escape those properly when calling 
                        from a batch file, or the F9 menu!)

Example setup:

• Extract the UnicodeAdapter.exe to the ZTree Tools directory.
• Create a F9 menu item:

::Unicode-named file context menu
:: Purpose:         Displays context menu for file with unicode characters in file name
:: Author:          Martijn Coppoolse
:: Version:         2007-05-06, v1.0
:: ZTW ver:         v1.60+
:: OS version:      WinXP (perhaps Win2000 as well, but untested so far)
:: Requires:        UnicodeAdapter
:: Source:          http://www.ztwiki.com/tiki-index.php?page=u_UnicodeAdapter
:: Usage:           n/a
:: Note:            UnicodeAdapter.exe must be in #ZTTools folder, or adapt
:: History:         n/a
"#ZTTools\UnicodeAdapter.exe" <strong>%1</strong>

A second example illustrates the use of the /cmd option:

::Locate Unicode-named file in Windows Explorer
"#ZTTools\UnicodeAdapter.exe" %1 /cmd <strong>explorer.exe /e,/select,%%%%1</strong>

The UnicodeAdapter.exe cutable can be placed anywhere you wish, but if you put it somewhere other than #ZTTools, make sure you adjust the menu items to reflect the different location!

Known bugs and limitations

• When a file's extension contains characters that convert to a dot '.' in the OEM or ANSI charsets, it will probably not get recognized.
• When multiple characters in a filename get converted to "quotes", there might be problems reading the command line.

Future plans

Depending on time and popular demand... ;-)

• (none so far)

Of course, we all hope that ZTreeWin itself will have full Unicode support soon, so this utility will become obsolete!

Download

Latest version:
UnicodeAdapter_v1.0.2.rar (334.42 Kb) 2007-May-13 00:16 +02:00 (CET)

Bugfix release
* Now correctly matches both ANSI-converted files and OEM/ANSI-converted files (ZTreeWin's /O option)
+ Keyboard access to all functionality of list with multiple matches

Previous versions:
UnicodeAdapter_v1.0.1.rar (334.39 Kb) 2007-May-11 00:18 +02:00 (CET)

First bugfix release. :)

Changes:
+ Gives help info when /? supplied on command-line
+ Now matches both ANSI-converted files as well as OEM/ANSI-converted files
* Handle exceptions with regular message boxes; don't crash (e.g. when no parameters have been supplied)
* The process actually terminates when it's done (woohoo!)

UnicodeAdapter.rar (333.47 Kb) 2007-May-06 13:26 +02:00 (CET)

* First public release

---