Difference between revisions of "IDE Window: Editor Options"

From Free Pascal wiki
Jump to navigationJump to search
m (Fix page link)
 
(20 intermediate revisions by 7 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:
<h3>Please go to [[IDE_Window:_Editor_Options_General|Editor Options General]] for options regarding:</h3>
+
*The menu: "Tools" => "Options" / Editor options ...
*Undo / Redo
+
*The source-editor pop-up menu: "Editor properties ...
*Scrolling
 
*Indent and Tabs
 
::Please also see Codetools for automatic indent of Pascal sources
 
*The Caret (Text-cursor)
 
*The block-selection
 
  
= General / Misc =
+
The available editor options are:
<h3>Please go to [[IDE_Window:_Editor_Options_General_Misc|Editor Options General Misc]] for options regarding:</h3>
+
*[[IDE Window: Editor Options General|General]]
*Showing Withespace
+
**Undo / Redo
*Trimming spaces
+
**Scrolling
*Copy/paste: unselected / fold
+
**Indent and Tabs<br />Please also see Codetools for automatic indent of Pascal sources
*Search
+
**Cursor
 
+
**Selection
= Display =
+
**[[IDE_Window: Editor Options General Misc|Misc]]
<h3>Please go to [[IDE_Window:_Editor_Options_Display|Editor Options Display]] for options regarding:</h3>
+
***Showing Whitespace
*Gutter / Margin
+
***Trimming spaces
*Font
+
***Copy/paste: unselected / fold
*Line-spacing
+
***Search
 
+
*[[IDE Window: Editor Options Display|Display]]
= Key Mappings =
+
**[[IDE Window: Editor Options Display Gutter|Gutter / Margin]]
 
+
**Font
See [[Lazarus IDE Shortcuts]].
+
**Line-spacing
 
+
** [[IDE_Window:_Editor_Options_HighlightColors|Colors]]
== Filter ==
+
*** Highlighting Pascal/Language specific elements
 
+
*** General Highlighting (Selection, Line Highlights, ...)
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.
+
**[[IDE_Window:_Editor_Options_Markup|Markup and Matches]]
 
+
*** Highlight other occurrences of the current word
== Tree of IDE shortcuts ==
+
*** Matching brackets
 
+
*** Extended Pascal-Keyword settings
Here you can see all commands and shortcuts of the IDE.
+
* [[IDE_Window:_Editor_User_Defined_Words|User defined markup]]
Click on one of the keys to popup a dialog to edit the shortcut.
+
* Highlight your own chosen words
 
+
**[[IDE_Window:_Editor_Options_Keymap|Key Mappings]]
== Find key combination ==
+
*** Keyboard
 
+
*** See [[Lazarus IDE Shortcuts]].
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.
+
** [[IDE_Window:_Editor_Options_Mouse|Mouse settings]]
 
+
*** Mouse
== Choose scheme ==
+
*[[IDE_Window:_Editor_Options_Completion_Hints|Completion and Hints]]
 
+
** Automatic removal of unused events
Load one of the predefined key mappings. This will replace '''all''' your shortcuts.
+
** Automatic completion of Pascal blocks (begin/end)
 
+
** Automatic completion of identifiers
== Check consistency ==
+
** Hints in the Editor
 
+
* [[IDE_Window:_Editor_Options_Code_Folding|Code Folding]]
Search for double defined keys.
+
** Source/Text folding
 
+
* [[IDE_Window:_Divider_Drawing_Divider_Draw|Divider Drawing]]
= Mouse =
+
** Drawing divider lines
 
+
* [[IDE_Window:_Editor_Options_MultiWindow|Pages and Windows]]
== See [[IDE_Window:_Editor_Options_Mouse|Mouse settings]] ==
+
** Notebook and its tabs
 
+
** Automatic selection of windows for code navigation
= Colors =
 
 
 
== See [[IDE_Window:_Editor_Options_HighlightColors|Color and Highlight settings]] ==
 
 
 
= Automatic Features =
 
 
 
== Auto remove empty methods ==
 
 
 
Published methods without code are automatically removed on save. For example: When you double click on a form the IDE creates the published method FormCreate. When this is option is enabled and the method is still empty the IDE will remove it when you save the form.
 
 
 
== Tooltip symbol Tools ==
 
 
 
When the mouse moves over an identifier in the source editor and waits a few seconds the IDE will present a hint with some informations.
 
 
 
== Complete blocks ==
 
 
 
Complete blocks. For example, when you type ''begin'' and press return the IDE will automatically add the ''end;''.
 
This feature exists since 0.9.27.
 
 
 
== 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.
 
 
 
== Markup ==
 
 
 
There are a couple of options to control the current-word-markup
 
feature. They are on the "Automatic feature" page of the editor option
 
(plus color settings on the color page)
 
 
 
Note: If you have a block selected, the selected block will be used as
 
term to highlight, rather than the word under caret.
 
Some settings are only for block, others only for current-word
 
 
 
1) You can change the time after which highlighting kicks in. You can
 
also disable the Timer completely, in which case you can still toggle
 
Highlighting by Keyboard
 
 
 
2) Toggle by Keyboard (default Alt-M)
 
You can toggle the highlight to any chosen word, or selection by
 
pressing Alt-M while at the word, or while having selected the desired
 
block.
 
Pressing Alt-M again will set the "fixed" word to the word at your new
 
location. To untoggle, press Alt-M twice at the same location
 
(The exact behaviour is: If your current selected block, or (if no block
 
selected) the current word under cursor is the same term as the word you
 
toggled-fixed, this will clear the fixed word. Otherwise the fixed word
 
will be set)
 
 
 
3) You can ignore Keywords. This is a hardcoded list of Keywords, and
 
will ignore them even if they are used in a context where they would not
 
be seen as Keyword. The list comes from the highlighter, so this only
 
works together with the highlighter.
 
 
 
4) for current-word only:
 
You can choose to only highlight exact matches(match word boundaries)
 
instead of any occurrence including occurrences in other words. By
 
Default this applies to words shorter than 3 chars.
 
 
 
For example:
 
Set option to true and field to 3.
 
 
 
If the word at caret is the 3 letter word 'laz' then all 'laz' will be marked, but not 'lazarus' or 'blaz'.
 
 
 
If the word at caret is the 4 letter word 'laza' then all words including 'laza' will be marked, such as 'lazarus'.
 
 
 
 
 
5) blocks only:
 
by default leading/trailing spaces are ignored/stripped from the search term
 
 
 
To disable the feature completely:
 
Set all colors (FG,. BG and Frame) to default (check the tickbox); make
 
sure no Styles (bold, italic) are selected.
 
 
 
This will be recognized, and the Editor is clever enough and will not
 
even trigger the search for other words.
 
 
 
== Bracket Highlight ==
 
 
 
If the cursor is behind or in front of a bracket, highlight matching bracket
 
 
 
= Code folding =
 
 
 
Define which constructs in your source can be folded. See [[IDE_Window:_Editor_Options_Code_Folding|Code Folding]]
 
 
 
= Divider Draw Level =
 
* Lazarus 0.9.26
 
:This option will draw a horizontal line based on the code folding level you specified.
 
::'''Example:'''
 
:* If you set this option to 1, the editor will draw a horizontal divider line in the editor after the 'end' keyword of each method. This is very handy if you want a visual cue where methods start and end.
 
:* If you set this option to 2, it will draw another horizontal line after the 'end' keyword of any nested begin..end block inside methods.
 
:* The higher you set the value the more nested begin..end blocks will be included.
 
 
 
* Lazarus 0.9.28
 
 
 
Allows to draw a vertical line at the end of selected structures. E.g draw a line after each procedure. See [[IDE_Window:_Divider_Drawing|Divider drawing]]
 
 
 
= Multi Window =
 
please see [[IDE_Window:_Editor_Options_MultiWindow]]
 

Latest revision as of 06:13, 4 November 2021

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

IDE Options - Editor

This is part of the online help for the IDE.

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 ...

The available editor options are: