Script Editor Tools
Parent page: Scripting
The Altium Designer Scripting system is conceptually composed of two parts; the editor and the debugger. The editor offers a range of scripting code help and inspection features, and the scripting panels provide access to script components and debug features.
The scripting system provides a range tools to help you write and debug scripts. Along with automated code completion and analysis capabilities, the scripting system allows you to interactively step through scripts line by line, inspect variables and objects and set breakpoints on one or many lines in the script.
The Scripting System editor supports a Code Completion feature, which is an automated pop-up window that displays context-sensitive code options.
When you type a period (dot/full-stop character) after an an object interface name, a list of available properties and methods for that object are shown in a pop up menu window (after a brief pause). Selecting an option from the list will populate the code with that procedure/function or property.
You can also use the Ctrl+Space shortcut keys to bring up the Code Completion list window at any time.
The Code Completion feature is extremely useful when selecting the correct Object Interface, method and property to apply in a script.
The script template feature will automatically generate a code structure for the statement selected from the pop-up list window.
The pop-up list can be activated at any time by the Ctrl+J shortcut keys or the Show Code Templates button . If activated after typing the first few letters of a code statement, for example, '
proc', the matching statement code will automatically populate the document code with the
Alternatively, if there are a number of statements available for the pre-typed code letters (for example '
if') the template list window will offer a filtered list of statements.
The Script Method Parameters feature displays a pop-up message that shows which parameters are used for a particular method (function/procedure etc) of an object interface.
When the initial round bracket is typed following a method, as shown in the image below, the Parameters message will automatically appear.
The Shift+Ctrl+Space keys can be used to manually display the Parameters pop-up message, where applicable.
To see the parameter definition for a completed method statement, place the cursor within its parameters brackets and use Shift+Ctrl+Space to the call the pop-up.
The source of a script variable or method definition can be instantly located using the editor's Navigation feature.
To locate a definition source for a variable, press the Ctrl key while clicking on the variable where it's used in the script. The cursor will relocate to the definition.
Use the same method (Ctrl+Click) to locate a procedure's source definition. If the procedure is defined in another script within the project, that script will open with the cursor at the procedure.
The Insight ToolTip feature shows the variable type when the mouse cursor is hovering over the variable.
Similarly, hovering the mouse over a procedure shows its definition and location (script and line number).
Breakpoints are a primary debugging tool that allow you to pause the execution of a script at predefined points.
The simplest way to specify a Breakpoint is by clicking in the editor's gutter alongside a line of code, which becomes highlighted in red. The line highlighting will change to blue when a running script has encountered a Breakpoint. The script can run to the next Breakpoint with the Run command or button .
Breakpoints can be accessed via the Breakpoints panel to easily locate and manage all set breakpoints, without going through a script to locate them.
When a script is stopped in response to a breakpoint or error, the value of any expression (a script statement) can be determined by a ToolTip feature or via the interactive Evaluate dialog.
The Evaluation tools are a primarily debugging tools, used in conjunction with debugging help panels such as the Watch List and Call Stack panels.
The Expression Evaluation ToolTip feature displays data values for the variable that the cursor is hovering over.
To use the editor's Evaluate dialog, click on an expression variable in the script and select the Evaluate button or press the Ctrl+F7 shortcut keys. The dialog will be automatically populated with the expression and its current result.
Alternatively, you can copy an expression from the script to the dialog's Expression field and click Evaluate to see the result. An expression name can also be typed directly into the Expression field to evaluate the result.
Bookmarks are used in a scripts to note statement and navigate to it quickly. Up to 10 bookmarks can be defined in a script.
A Bookmark is indicated by a dark green box with the Bookmark number enclosed. To add a bookmark, select a line of code, right click then select Toggle Bookmarks and a location number from the context menu (Toggle Bookmarks » Set Location Mark n, where 'n' is the bookmark number from 0 to 9).
To go to (jump to) a Bookmark, right click then select Goto Bookmarks and the desired bookmark location from the context menu (Goto Bookmarks » Jump Location Mark n). To remove a Bookmark, toggle the bookmark off by repeating the add bookmark process for that code line.
Use the Ctrl+n shortcut keys to jump to an existing bookmark in the script (where n is the bookmark number from 0 to 9) — for example, to go to bookmark number 3, press the Ctrl+3 shortcut keys.
Use the Ctrl+Shift+n short cut keys to toggle a bookmark (where n is the bookmark number to toggle), or move an assigned Bookmark to the current line.
Scripting Shortcut Keys
Shortcut keys are assigned to common scripting operations, as detailed below. To see the general Altium Designer shortcut keys, open the Shortcuts panel by clicking on the Shortcuts button at the lower right of Altium Designer.
|F9||Run the current script. If a run script is not defined, nominate a startup script procedure to execute in the the Select Item to Run dialog.|
|Ctrl+F9||Run the script to the current cursor position, then pause.|
|Ctrl+F3||Halt (stop) a currently running script procedure.|
|F5||Toggle a Breakpoint for the current script line (or click in the gutter area).|
|Ctrl+Space||Pop up the Code Completion list window.|
|Ctrl+J||Pop up the Statement Templates list window.|
|Shift+Ctrl+Space||Activate the Method Parameters pop up window.|
|Ctrl+F||Open the Find Text dialog.|
|F3||Find next text instance.|
|Ctrl+H||Open the Replace Text dialog.|
|Ctrl+[0 - 9]||Jump (go to) a Bookmark location mark — for example, Ctrl+3 jumps the cursor to Bookmark number 3.|
|Ctrl+Shift+[0 - 9]||Toggle a Bookmark on the current line, or move an assigned Bookmark to the current line.|
|CTRL+Click on variable/method||Jump the cursor to the respective variable/method declaration point.|
|F7||Step into and execute the next line of code. Use to execute the current script one line at a time.|
|F8||Step over (execute without stopping) a called procedure. If the line statement is not a called procedure, step into and execute the line as normal.|
|Ctrl+F7||Open the script Evaluate dialog to see the current value (result) of the expression located at the cursor.|
|Ctrl+Alt+B||Open the Breakpoints panel.|
|Ctrl+Alt+S||Open the Call Stack panel|
|Ctrl+Alt+E||Open the Code Explorer panel|
|Ctrl+Alt+I||Open the Object Inspector panel|
|Ctrl+Alt+P||Open the Tool Palette panel|
|Ctrl+Alt+W||Open the Watch List panel|