Defining Text Editors Preferences for Altium Designer

The Text Editors category of the Preferences dialog provides access to preferences relating to features and functionality associated with the Text editor.

General Copy Link Copied

The Text Editors – General page of the Preferences dialog provides configuration controls related to the editing behavior of the Text editor.

The Text Editors – General page of the Preferences dialog

Editing

• Insert Mode - enable to insert text at the cursor without overwriting existing text. If this option is disabled, text entered at the cursor is overwritten.

  The keyboard Insert key can be used to toggle Insert Mode in the Text editor without changing this default setting. The mode is indicated by the Overwrite or Insert message on the status bar.

• Overwrite cursor as block - enable to overwrite the cursor as a block.

• Cursor through tabs - enable to allow the arrow keys to move the cursor to the logical spaces within each tab character.

• Cursor beyond EOL - enable to allow the cursor to be positioned beyond the end-of-line (EOL) character on the text document.

• Cursor beyond EOF - enable to allow the cursor to be positioned beyond the end-of-file (EOF) character on the text document.

• Persistent blocks - enable to keep marked blocks on the text document marked even when the cursor is moved using the arrow keys. When a new block is selected, the previous block is removed.

• Overwrite blocks - enable to allow a marked block of text to be replaced with whatever is typed next. If the Persistent blocks option is also selected, text entered is appended following the currently selected block.

• Disable dragging - enable to inhibit the ability to drag selected blocks of text across the text document. By default, this option is disabled.

• Group undo - enable to undo the last editing command, as well as any subsequent editing commands of the same type.

• Remember undo/redo after save - enable to make undo data remain after a text file is saved allowing all changes to be reverted. This option is enabled by default. Disable this option and all the undo data is lost after saving a text file.

• Smart 'Home' key - enable to make the Home key (when used for the first time) cause the cursor to jump to the first non-space character in the current line. With the next Home key press, the cursor will jump to the beginning of the line, and so on. This Home key behavior matches that of the Microsoft™ Visual Studio™ product. Disable this option to cause the cursor to jump to the beginning of the current line when the Home key is pressed.

Find

• Find text at cursor - enable to cause the current text at the cursor to be placed into the Text to find field in the Find Text dialog. If this option is disabled, the search text must be manually entered.

• Find selected text on Find Next - enable this option to quickly find subsequent occurrences of the currently selected text, instead of the text that was used in the original find text action.

• Select found text - enable to copy the found text to the clipboard when the copy command is used.

Import

• Import from - click to import Text Editor Preference settings then choose from Tasking or Visual Studio.

Tabs & Indent

• Use tab character - when enabled, a literal tab character is inserted for each tab. When disabled, space characters are inserted instead. Enable the Use special symbols option on the Text Editors - Display Preferences page to see tab characters in the text document.

• Optimal fill - enable to make a line auto-indent with the minimum number of characters possible, using tabs and spaces as necessary. Enable the Use special symbols option on the Text Editors - Display Preferences page to see the tab symbols on the document.

• Smart tab - enable to have a new line tab to match the position of the first non-whitespace character on the preceding line.

• Auto indent mode - enable to create a new line when Enter is pressed. The cursor will indent the same as the position of the first non-whitespace character on the preceding line.

• Smart indent mode - enable to enable programming-aware tab behavior; currently used only when editing C files. For example, when this option is enabled and a closing curly bracket is typed, the editor will indent this character so that it is aligned to the matching opening curly bracket. Disable this option and the tab behaves normally.

• Backspace unindents - enable to have the backspace key remove an indent in one key press.

  • Tab Stops - use to define the editor tab stops in a number of characters represented by a tab.

  • Block Indent - use to specify the standing number of spaces to indent text, and the indent/outdent space used for a marked block of text. The indent and outdent block key commands are Ctrl+Shift+I and Ctrl+Shift+U respectively.

   

Key Mapping

Select one of the following Key Mapping assignments for editing a text document:

• Default - map the editor keys to match CUA mappings.

• Borland Classic - map keys to match the Borland Classic editor keys.

• Brief - map keys to match the Brief keystrokes.

• Epsilon - map keys to match the Epsilon keys.

• Visual Studio - map keys to match the Visual Studio editor.

Advanced

• Double click line - click to highlight a line when a character in the line is double-clicked. If this option is disabled, only the selected word is highlighted.

• Unix EOL style - click so that when a text file is saved, each line will be separated using a single LF character (Unix style) instead of a CR/LF pair.

• Compress undo motion - enable so that changing the caret position does not go into the undo list. Normally, if text is modified and the PageUp key is pressed, Undo would have to be used twice to restore the text to the original state. With the Compress Undo Motion enabled, that can be done with a single Undo.

• Advanced block editing -  click to have all the selected blocks simultaneously overwritten when typing.

Display Copy Link Copied

The Text Editors – Display page of the Preferences dialog provides controls and information related to text display.

The Text Editors – Display page of the Preferences dialog

Font

Editor Front: Change - click to access the standard Windows Font dialog in which you can configure the font used for text documents. The field to the right reflects the current font for the Text Editor.

Visual

• Visible right margin - enable the display of a right-hand margin on the text document. You can adjust the margin width by entering a new value in the Margin width field. The right margin is used for visual formatting and for word wrapping.

• Show line numbers - enable the display of line numbers on the text document. Use the following sub-options to configure how the numbering is displayed:

  • Line numbers on gutter - enable the line numbers to appear on the gutter. If this option is disabled, the line numbers are displayed in a column next to the gutter within the document itself.

  • Show all numbers - enable the display of all line numbers. With this option disabled, the line number for every tenth line will be displayed, with tick marks for all other lines (major tick lines for every fifth line).

   

• Use special symbols - enable the display of special symbols, such as those for a carriage return or end of line.

• Word wrap - enable to have text wrap in accordance with one of the following options:

  • Wrap at margin - select to have lines of text wrap around at a right-hand margin line. Ensure that the Visible right margin option is enabled, and define the width of the margin using the Margin width field.

  • Wrap at window - select to have lines of text wrap around at the right-hand edge of the text document visible design space.

   

• Indicate modified lines - enable to have lines of text that are modified or added automatically highlighted with color markers on the gutter. Unsaved changes are indicated with red markers, while saved changes are indicated with green markers. This allows you to quickly identify which text is committed.

Syntax Highlighting

• Use syntax highlighting - enable to enable syntax highlighting. To set highlighting options, use the Text Editors - Colors page.

• Highlight brackets - enable to highlight the brackets in the text, which is useful for identifying opening and closing brackets.

• Automatic delimiter highlighting - enable control of whether matching pairs of delimiter characters are highlighted. For example, when this option is enabled, when you close a bracket, the text editor will highlight it.

• Underline typing errors - enable to underline any typing errors.

Code Outlining

Use Code Outlining - enable to view a small box that appears for each procedure/function/sub-routine on a text document. Each routine can be collapsed to one line or expanded by clicking on the small box. Use the Show Collapse Lines and Buttons on Gutter options to have more control over the Code Outlining feature.

Colors Copy Link Copied

The Text Editors - Colors page of the Preferences dialog provides controls and information related to text colors.

The Text Editors – Colors page of the Preferences dialog

Editor Colors Settings

• Color SpeedSetting - use the drop-down list to select the desired color setting. Choices include:

  • Custom

    If Custom is selected, color settings can be set manually using the controls located in the lower region of the dialog.

  • Default

   

• Element - lists all elements that exist in the text. Each element has a default setting that is available in the lower region of the dialog.

  If the default setting is enabled, the default color is shown in the associated drop-down as well as in the Example region.

• Foreground Color

  • Use default color - enable to use the default foreground color. Use the drop-down list to select a system-defined foreground color for the selected element. 

   

• Background Color

  • Use default color - enable the use of the default background color. Use the drop-down list to select a system-defined background color for the selected element.  

   

• Text attributes - enable desired boxes to define attributes for the text.

   

Additional Controls

• Load Colors - click to open the Load Color Scheme dialog in which you can load color settings (*.clr files) from external sources.

• Save Colors - click to open the Save Color Scheme As dialog in which you can save the color settings as a *.clr file.

• Configure Language - click to open the Language Setup dialog in which you can manage a list of languages that can be associated with documents opened in the Text editor. 

• Edit Current Language Syntax - click to open the Syntax Editor dialog in which you can edit the syntax of the current language.