
Autor: MGP Software Ltd.

-------------------------------------------------------------------------------
  TCToolbar 1.3
-------------------------------------------------------------------------------
TCToolbar is extension to the Buttonbar of Total Commander. TCToolbar adds second temporary toolbar in addition to the permanent TC Buttonbar.

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


-------------------------------------------------------------------------------
  Changes History
-------------------------------------------------------------------------------
- Toolbar disappears on ESC key

-------------------------------------------------------------------------------
  Usage
-------------------------------------------------------------------------------
1. Create a new button.
2. Assign TCToolbar.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 TCToolbar 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 TCToolbar 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 TCToolbar 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 TCToolbar 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>.


