IDE Window: Editor Options

From Lazarus wiki
Revision as of 16:27, 9 August 2008 by HowardPC (talk | contribs) (Persistent cursor)

Deutsch (de) English (en) español (es) suomi (fi)

You can get this dialog via:

  • Menu / Environment / Editor options ...
  • Source editor / popup menu / Editor properties ...


Alt-Key sets column mode

There are two selection modes: All characters between Start and End. Or a rectangular area between Start and End. You can switch between those modes by pressing Alt and selecting with the mouse. This does not work under X, because the Alt+Mouse key is almost always already used by the window manager.

Auto indent

When inserting new lines (e.g. through pressing Return or Enter key), the editor will indent the caret on the new line with the same amount of leading white space as the preceding line.

Bracket highlighting

If the cursor is behind or in front of a bracket, highlight matching bracket.

Show gutter hints

Show hints when mouse is over the gutter (the bar on the left side of the source editor).

Show special characters

Spaces are shown as dots and invalid characters as question marks.

Use syntax highlight

Use colors and styles for different tokens. You can setup the highlighting in the editor options / colors.

Show scroll hint

Started, but not yet implemented: Shows a hint of the visible line numbers when scrolling vertically.

Drag Drop editing

Allows you to select a block of text and drag it within the document to another location.

Drop files

Not implemented yet: Allows the editor accept file drops.

Half page scroll

When scrolling with page-up and page-down commands, only scroll a half page at a time.

Keep cursor X position

When moving through lines w/o Cursor Past EOL, keeps the X position of the cursor.

Persistent cursor

Keep cursor blinking, even if losing focus. The is needed on some systems, where the focus messages do not work properly.

Cursor skips selection

When there is a selection and you press the left arrow, the cursor will go to the start of the selection.

Right mouse moves caret

When clicking with the right mouse for a popup menu, move the cursor to that location.

Scroll by one less

Forces scrolling to be one less line.

Scroll past end of file

Allows the cursor to go past the end of file marker.

Scroll past end of line

Allows the cursor to go past the last character into the white space at the end of a line.

Home key jumps to nearest start

home key jumps to line start if nearer, similar to visual studio.

Always visible cursor

Move cursor to be always visible when scrolling.

Smart tabs

When tabbing, the cursor will go to the next non-white space character of the previous line. If the current line is longer than the previous, it will look for a longer line in front.

Tabs to spaces

When editing lines the editor adds spaces instead of tabs. The rest of the lines will not be altered and the tabs are kept. To convert all tabs of a file select the whole file (Ctrl-A) and use Main menu / Edit/ tabs to spaces.

Tab indents blocks

When active <Tab> and <Shift><Tab> act as block indent, unindent when text is selected.

Trim trailing spaces

Spaces at the end of lines will be trimmed and not saved. This applies only to edited lines.

Undo after save

Keep the Undo list on save.

Group Undo

When undoing/redoing actions, handle all continuous changes of the same kind in one call instead of undoing/redoing each command separately.

Double click line

Select line on double click.

Mouse links

Pressing Ctrl will highlight the word under the mouse cursor.

Show close buttons in notebook

Show a close button on each source editor tab. Not all widgetsets support this. At the moment only the gtk interface.

Find text at cursor

When invoking the 'Find' dialog, fetch the word at the cursor and put it into the Find field.

Copy word on copy none

If nothing is selected and user presses Copy (Ctrl-C), the editor selects the word and copy that. Same for cutting.

Block indent

Amount of spaces a block is indented. For example with Ctrl+I.

Undo limit

Maximum number of Undo steps.

Tab widths

Maximum spaces for Tab characters.


Margin and gutter

  • Visible right margin - show the right margin line
  • Visible gutter - show the left bar
  • Show line numbers - show line numbers in the gutter
  • Right margin color and position in characters
  • Gutter color

Default editor font

  • Font name - Can be as simple as 'courier' or as complicated as '-adobe-courier-medium-r-normal-*-*-140-*-*-*-*-iso10646-1' under gtk/X.
  • Editor font height
  • Extra line spacing - extra space between lines in pixels.

Key Mappings

See Lazarus IDE Shortcuts.


At the top there is an edit field to set a text filter. You can type some letters and the tree will be updated to show only those keys which description contains the word. Set empty to show all.

Tree of IDE shortcuts

Here you can see all commands and shortcuts of the IDE. Click on one of the keys to popup a dialog to edit the shortcut.

Find key combination

Click on the button to show a dialog. Grab a key and press ok. The tree will then only show those keys that start with the shortcut. Select VK_UNKNOWN to show all.

Choose scheme

Load one of the predefined key mappings. This will replace all your shortcuts.

Check consistency

Search for double defined keys.


This page allows to edit the syntax highlighters of the IDE. The main syntax highlighter is the Object Pascal highlighter. All other highlighters use those colors as default.


Set here the highlighter you want to edit.


The IDE has some predefined color schemes - sets of colors. Choose here one you like, then edit the single elements.

File Extensions

You can edit the file extensions for which the IDE uses this highlighter.


This listbox contains all elements of the current highlighter. Choose which to edit. Or click on the preview below to select the element.

Set element to default

Load the default colors for this element from the current highlighter and scheme.

Set all elements to default

Load the default colors for the current highligher and scheme.

Text attributes

Check the 'Use default color' checkboxes to get the color button. Then click on the button to select a custom color.

Code Tools

Identifer Completion

Start automatically the Identifier completion, when user types a point '.' and waits.

Tooltip symbol Tools

Show hints when moving the mouse over an identifier. While editing, this will do a Find Ddeclaration. During debugging this will do an Evaluate variable.

Tooltip expression evaluation

During debugging the tooltip hint will try to evaluate the expression at the cursor.


Set here the waiting period before the hint pops up.

Code folding

Mark blocks of code and let the user fold them.