|
Directives
Syntax
Most lines in TCI.INI consist of a one-word directive, an equal sign =, and a value. For example, in the following line, the word Transparency is the directive and 255 is the value:
Transparency = 255
Any spaces before or after the equal sign are ignored.
Regardless of how long a string value is, you must enter it all on one line. Strings cannot be continued to a second line.
Each line must be less than 2,047 characters.
The format of the value part of a directive line depends on the individual directive. It may be a numeric value, a single character, a choice (like Yes or No), a color setting, a filename, or a text string. The value begins with the first non-blank character after the equal sign and ends at the end of the line or the beginning of a comment.
Blank lines are ignored in TCI.INI and can be used to separate groups of directives.
You can place comments in the file by beginning a line with a semicolon ;. You can also place comments at the end of any line except one containing a text string value. To do so, enter at least one space or tab after the value, a semicolon, and your comment, like this:
Transparency = 250 ;set window transparency to not quite opaque
If you try to place a comment at the end of a string value, the comment will become part of the string and will probably cause an error.
If you use the configuration dialogs to modify TCI.INI, comments on lines modified from within the dialogs will not be preserved when the new lines are saved. To be sure TCI.INI comments are preserved, put them on separate lines.
When TCI detects an error while processing TCI.INI, it displays an error message and prompts you before processing the remainder of the file. This allows you to note any errors before the startup process continues. The directive in error will retain its previous or default value.
If you need to test different values for a TCI.INI directive without repeatedly editing the file, see the INIQuery directive.
Types of Directives
There are various types of directives in TCI.INI. The type of a directive is shown under the individual help topic for that directive. The types are distinguished by the kind of data, if any, that must be entered after the = (equal sign):
Name = nnnn (1234): This directive takes a numeric value which replaces the "nnnn." The default value is shown in parentheses or listed below the directive's description.
Name = CHOICE1 | Choice2 | ... : This directive must be set to one of the vertical bar separated values listed between the braces. The default value is shown in all upper case letters in the directive description, but in your file any one of the choices can be entered, using any case. (Do not enter the vertical bar.) For example, if the choices were shown as YES | No then YES is the default.
Name = Path: This directive takes a path specification, without a filename. The value should include both a drive and path (e.g., C:\TCI\) to avoid any possible ambiguities. A trailing backslash \ at the end of the path name is accepted but not required. Any default path is described in the text.
Name = File: This directive takes a filename. We recommend that you use a full filename including the drive letter and path to avoid any possible ambiguities. Any default filename is described in the text.
Evaluation of Directives
The directives are evaluated sequentially from top to bottom. When a directive is processed more than once during startup, the value replaces any previous one(s).
Directives by Name
IBeamCursor |
Set text cursor style |
InactiveTransparency |
Default transparency for inactive TCI window |
INIQuery |
Query for each line in the .INI file |
COMSPEC |
Set default command processor |
ConsoleAltKey |
Send Alt key messages to console |
ConsoleBufferRows |
Set console screen buffer size |
ConsoleMouse |
Send mouse messages to console |
LeftAltKey |
Pass left Alt key to TCI |
LeftCtrlKey |
Pass left Ctrl key to TCI |
LinuxSelection |
Automatically copy to clipboard upon selection |
MultiLineTabs |
Set single line or multiple lines for the tab labels |
RegularExpressions |
Sets the regular expression syntax type for searches |
RightAltKey |
Pass right Alt key to TCI |
RightCtrlKey |
Pass right Ctrl key to TCI |
ScreenColumns |
Set screen columns at startup |
ScreenRows |
Set screen rows at startup |
ScrollWrap |
Set tab scroll key wrap mode |
SettingChange |
Monitor WM_SETTINGCHANGE message |
SingleInstance |
Only allow one instance of TCI |
StatusBarOn |
Set status bar mode at startup |
StatusBarText |
Point size of status bar text |
StdColors |
Default window colors |
TabCloseButton |
Display close button (X) in the tab label |
TabIcons |
Set icon display in the tab label |
Tabs |
Put tabs on top or bottom of window |
TabSize |
Set the maximum tab text length |
ToolBarOn |
Set tool bar mode at startup |
ToolBarText |
Point size of tool bar text |
Transparency |
Default transparency for TCI window |
Tray |
Minimize TCI to the system tray instead of the taskbar |
UpdateTitle |
Set TCI title to current tab title |
WindowHeight |
Initial height of the TCI window |
WindowState |
Initial state for the TCI window |
WindowWidth |
Initial width of the TCI window |
WindowX |
Initial position of the left border of the TCI window |
WindowY |
Initial position of the top border of the TCI window |
Wow64FsRedirection |
Set debugging options |
»
|