|
|
| (70 intermediate revisions by 12 users not shown) |
| Line 1: |
Line 1: |
| − | {{IDE Window: Editor Options}} | + | <noinclude>{{IDE Window: Editor Options}}<!--- This page may be used as template in other pages ---></noinclude> |
| | + | [[File:IDE-options-editor.JPG|thumb|600px|IDE Options - Editor]] |
| | | | |
| − | You can get this dialog via:
| + | This is part of the online help for the IDE. |
| − | *Menu / Environment / Editor options ...
| |
| − | *Source editor / popup menu / Editor properties ...
| |
| | | | |
| − | == General == | + | It describes the section: "Editor Options". You can open the described dialog in your IDE via: |
| | + | *The menu: "Tools" => "Options" / Editor options ... |
| | + | *The source-editor pop-up menu: "Editor properties ... |
| | | | |
| − | === Alt-Key sets column mode ===
| + | The available editor options are: |
| − | There are two selection modes: All characters between Start and End. Or a rectangular area between Start and End.
| + | *[[IDE Window: Editor Options General|General]] |
| − | 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.
| + | **Undo / Redo |
| − | === Auto indent ===
| + | **Scrolling |
| − | 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.
| + | **Indent and Tabs<br />Please also see Codetools for automatic indent of Pascal sources |
| − | | + | **Cursor |
| − | === Bracket highlighting ===
| + | **Selection |
| − | If the cursor is behind or in front of a bracket, highlight matching bracket.
| + | **[[IDE_Window: Editor Options General Misc|Misc]] |
| − | === Show gutter hints ===
| + | ***Showing Whitespace |
| − | Show hints when mouse is over the gutter (the bar on the left side of the source editor).
| + | ***Trimming spaces |
| − | === Show special characters ===
| + | ***Copy/paste: unselected / fold |
| − | Spaces are shown as dots and invalid characters as question marks.
| + | ***Search |
| − | === Use syntax highlight ===
| + | *[[IDE Window: Editor Options Display|Display]] |
| − | Use colors and styles for different tokens. You can setup the highlighting in the editor options / colors.
| + | **[[IDE Window: Editor Options Display Gutter|Gutter / Margin]] |
| − | === Show scroll hint ===
| + | **Font |
| − | Started, but not yet implemented: Shows a hint of the visible line numbers when scrolling vertically.
| + | **Line-spacing |
| − | === Drag Drop editing ===
| + | ** [[IDE_Window:_Editor_Options_HighlightColors|Colors]] |
| − | Allows you to select a block of text and drag it within the document to another location.
| + | *** Highlighting Pascal/Language specific elements |
| − | === Drop files ===
| + | *** General Highlighting (Selection, Line Highlights, ...) |
| − | Not implemented yet: Allows the editor accept file drops.
| + | **[[IDE_Window:_Editor_Options_Markup|Markup and Matches]] |
| − | === Half page scroll ===
| + | *** Highlight other occurrences of the current word |
| − | When scrolling with page-up and page-down commands, only scroll a half page at a time.
| + | *** Matching brackets |
| − | === Keep cursor X position ===
| + | *** Extended Pascal-Keyword settings |
| − | When moving through lines w/o Cursor Past EOL, keeps the X position of the cursor.
| + | * [[IDE_Window:_Editor_User_Defined_Words|User defined markup]] |
| − | === Persistent cursor ===
| + | * Highlight your own chosen words |
| − | Keep cursor blinking, even if loosing focus. The is needed on some systems, where the focus messages do not work properly.
| + | **[[IDE_Window:_Editor_Options_Keymap|Key Mappings]] |
| − | === Cursor skips selection ===
| + | *** Keyboard |
| − | When there is a selection and you press the left arrow, the cursor will go to the start of the selection.
| + | *** See [[Lazarus IDE Shortcuts]]. |
| − | === Right mouse moves caret ===
| + | ** [[IDE_Window:_Editor_Options_Mouse|Mouse settings]] |
| − | When clicking with the right mouse for a popup menu, move the cursor to that location.
| + | *** Mouse |
| − | === Scroll by one less ===
| + | *[[IDE_Window:_Editor_Options_Completion_Hints|Completion and Hints]] |
| − | Forces scrolling to be one less line.
| + | ** Automatic removal of unused events |
| − | === Scroll past end of file ===
| + | ** Automatic completion of Pascal blocks (begin/end) |
| − | Allows the cursor to go past the end of file marker.
| + | ** Automatic completion of identifiers |
| − | === Scroll past end of line ===
| + | ** Hints in the Editor |
| − | Allows the cursor to go past the last character into the white space at the end of a line.
| + | * [[IDE_Window:_Editor_Options_Code_Folding|Code Folding]] |
| − | === Home key jumps to nearest start ===
| + | ** Source/Text folding |
| − | home key jumps to line start if nearer, similar to visual studio.
| + | * [[IDE_Window:_Divider_Drawing_Divider_Draw|Divider Drawing]] |
| − | === Always visible cursor ===
| + | ** Drawing divider lines |
| − | Move cursor to be always visible when scrolling.
| + | * [[IDE_Window:_Editor_Options_MultiWindow|Pages and Windows]] |
| − | === Smart tabs ===
| + | ** Notebook and its 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.
| + | ** Automatic selection of windows for code navigation |
| − | === 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.
| |
| − | | |
| − | == Display ==
| |
| − | | |
| − | === 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]]. | |
| − | | |
| − | === Filter ===
| |
| − | | |
| − | 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.
| |
| − | | |
| − | == Color ==
| |
| − | | |
| − | 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.
| |
| − | | |
| − | === Language ===
| |
| − | | |
| − | Set here the highlighter you want to edit.
| |
| − | | |
| − | === Scheme ===
| |
| − | | |
| − | 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.
| |
| − | | |
| − | === Element ===
| |
| − | | |
| − | 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.
| |
| − | | |
| − | === Delay ===
| |
| − | | |
| − | Set here the waiting period before the hint pops up.
| |
| − | | |
| − | == Code folding ==
| |
| − | | |
| − | Mark blocks of code and let the user fold them.
| |
