
Author: MGP Software Ltd.

-------------------------------------------------------------------------------
  TCMenu 1.9
-------------------------------------------------------------------------------
TCMenu is extension to the Buttonbar of Total Commander. TCMenu adds drop-down menu functionality to the TC Buttonbar.

-------------------------------------------------------------------------------
  Changes History
-------------------------------------------------------------------------------
Version 1.9
- Fixed bug with drawing separators for Windows NT

Version 1.8
- Added support for nested .bar files. If choosen item contains in the command field .bar file name this bar will displayed instead of current menu. If parameter field contains word "menu", this .bar file will be attached to main menu as submenu.

Version 1.7
- If menu text for internal commands was not specified, TCmenu will take it from totalcmd.inc(wincmd.inc) file.
- Added support for CD command.
  Now you can define commands to change directories according to TC documentation. The only difference from TC behavior is that instead of settings directories on source/target panels TCmenu will set directories on left/right panels.

!!! WARNING !!! Using CD command in TCmenu was checked with TC 5.51 only and may not work with future TC versions.

Version 1.6
- Program renamed from WCmenu to TCmenu
- Program can be placed in any directory
- Improved internal command handling
- Fixed small bug related to Windows NT.

-------------------------------------------------------------------------------
  Usage
-------------------------------------------------------------------------------
1. Create a new button.
2. Assign TCMenu.exe to the button.
3. Fill the parameters field:
       Path to any Buttonbar file (.bar) to be used as menu configuration.
       List of parameters to be passed on execution of menu items. Each parameter is defined as 
       -x <string> , where
       "x" (any letter) specifies the corresponding TC parameter in buttonbar file (%x) which will be substituted with <string>. Usually <string> contains one of TC parameters(%p, %n, %l etc.) 


Example:
If you have defined button for notepad.exe in your MyEditors.bar file as
        Notepad.exe %p%n (that means full filename),

you can define parameters for TCmenu as:
        C:\Wincmd\MyEditors.bar -n %n -p %p
In this case %n parameter in "notepad definition" will be replaced with standard TC %n parameter and %p parameter in "notepad definition" will be replaced with standard TC %p parameter. 

On the other hand, you can make another definition with the same result. You can define parameters in MyEditors.bar as:
        Notepad.exe %A 

and define parameters for TCmenu as:
        C:\Wincmd\MyEditors.bar -A %p%n 

In this case %A parameter in "notepad definition" will be replaced with concatenation of standard TC %p and %n parameters.

-------------------------------------------------------------------------------
  Special parameters
-------------------------------------------------------------------------------
1. Small/Big icons parameter.
By default menu is displayed with big icons. To display small icons add -$ to parameters list.

2. User Input parameter.
You can use "?" parameter to get the opportunity to the user to modify command-line parameters before command execution. This parameter can be located at any place in parameter string (and even in environment variable!). The question marks located in strings enclosed in quotation marks are ignored. When dialog box for user input is displayed, cursor will be placed in the position corresponding to "?" position in the parameter string. You can place immediately after "?" some text (or text until space or text enclosed in quotation marks). This text will be used to prompt user about kind of input required. 

Examples:
    ?Year(00-99) 
or 
    ?"Would you be so kind to enter your birthday, sir?"

-------------------------------------------------------------------------------
  Environment Variables
-------------------------------------------------------------------------------
You can use environment variables (like %WinDir%) in the following fields:
1. Parameter field in TCmenu button definition. (p.e. -x %%OS%%)
2. Parameter field in subbar buttons definitions. (p.e. %%OS%%)
3. Command field in subbar buttons definitions. (p.e. %Windir%\notepad.exe)

Important! Variables in parameters fields should be enclosed in double percent signs.
If variable, specified in TCmenu button definition, will contain spaces after expansion, it will be enclosed in quotation marks.

-------------------------------------------------------------------------------
  Special Variables
-------------------------------------------------------------------------------
There are special variables available for using in subbars. These variables contain current time/date related information.

        %0 - hours
        %1 - minutes
        %2 - seconds
        %3 - day of month
        %4 - month
        %5 - year
        %6 - day of week
        %7 - month name

Example: cmd.exe /c md Backup_%3-%7-%5


-------------------------------------------------------------------------------
  Internal TC commands
-------------------------------------------------------------------------------
Displayed subbar can contain any internal TC command, except cm_List <filename>.


