Show/Hide Toolbars

Take Command / TCC Help v. 21

The IDE edit windows allow you to edit and debug Windows batch files.

 

If a file in a tab edit window has been modified but not yet saved, the tab title will be prefixed with a *. When the file is saved, the * is removed.

 

If you are using TCC syntax, you can get help for the currently selected (highlighted) command / variable / function by pressing Ctrl-F1, or right-clicking the mouse and selecting Help from the context menu. You can also hover the mouse over a TCC variable name, and the IDE will pop up a tooltip with the current value. If you hover the mouse over a TCC internal command name, the IDE will pop up a tooltip with the command syntax.

 

You can change the line to be executed next when in debugging mode by moving the caret to the line and either right clicking & selecting "Jump to This Line" or by pressing Ctrl-Shift-F11. Note that if you attempt to jump into or out of a DO loop or IFF block, bad things will happen!

 

You can block select in the edit window by holding down the Alt key while selecting text with the left mouse button.

 

The edit window supports multiple selections at one time. You can select additional text by holding down the Ctrl key while dragging with the mouse. Multiple selections are added to the clipboard in order with no delimiting characters. For block selections, the line end is added after each line of text. Block selections are always copied from top to bottom, not in the order of selection.

 

Margins

 

There are three possible margins on the left of the edit window:

 

The line number (selectable by the "Options / Display Line Numbers" menu option).

The Breakpoint margin (left click in this margin to set a breakpoint on this line).

The Fold margin (selectable by the "Options / Display Fold Margin" menu option), which will display a - for blocks that can be collapsed to a single line (DO, IFF, and SWITCH commands, and command groups). When a block is collapsed, the Fold margin will display a +. Left clicking in the Fold margin will toggle the fold state.

 

Syntax Coloring

 

The IDE will select the syntax lexer (colorization) based on the file extension:

 

.bat CMD (or optionally TCC)
.btm TCC
.cmd CMD (or optionally TCC)
.cssCSS
.htm HTML
.htmlHTML
.luaLua
.php PHP
.plPerl
.ps1PowerShell
.pyPython
.rbRuby
.shBash shell
.sqlSQL
.tclTcl/Tk
.vbsVBScript
.xmlXML

 

The edit window toolbar (which is configurable by clicking on the rightmost down arrow), has a number of icons to control debugging. Each has a tooltip for quick reference:

 

NewCreate a new batch file in a new tab window.
OpenOpen an existing batch file in a new tab window.
SaveSave the current batch file.
PrintPrint the current batch file.
CutCopy the highlighted selection to the clipboard and delete it from the file.
Copy Copy the highlighted selection to the clipboard.
PasteCopy the contents of the clipboard to the current cursor location.
DeleteDelete the highlighted selection.
UndoUndo the last edit.
RedoRestore the last Undo.
FindSearch for text.
Batch ArgumentsNew batch file arguments. The text will be parsed into %1 - %n batch arguments and used when the batch file is debugged.
Start DebuggingStarts the debugger. The cursor will be placed on the first line.
Pause DebuggingPause execution at the next line.
Stop DebuggingStops the debugger.
Step IntoExecute the current line.
Step OverExecute the current line but disable the debugger during a CALL or GOSUB.
Run to BreakpointExecute the batch file, stopping at the next breakpoint.
Toggle BreakpointSets or turns off a breakpoint on the current line.
Clear BreakpointsClear all breakpoints in the current batch file.
File PropertiesDisplays information on the current batch file.
Start New ShellStart another copy of TCC (this is useful if you need to perform some tasks while debugging a file.)
HelpDisplay the online help.