IDE Window: Editor Options Mouse: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: IDE Window: Editor Options Mouse

New		Line
1	+	This is part of the online help for the IDE. \
2	+	It describes the section: "Editor" / "Mouse". You can open the described dialog in your IDE via:\
3	+	*The menu: "Tools" =\> "Options" / Editor options ...
4	+
5	+	- The source-editor pop-up menu: "Editor properties ...
6	+
7	+	Navigation\
8	+
9	+	- [[IDE Window: Editor Options\|Editor Options]] Overview of all Editor Options
10	+
11	+
12	+
13	+	- [[IDE Window: IDE Options Dialog\|IDE Options]] Overview of all options for the IDE
14	+
15	+	------------------------------------------------------------------------
16	+
17	+	# General
18	+
19	+	## Hide mouse when typing
20	+
21	+	If the mouse is positioned over the editor, it will be hidden while you type. Any mouse-move, click, or menu action will make it visible again.
22	+
23	+	# Gutter
24	+
25	+	You can currently choose between two predefined modes for the gutter area
26	+
27	+	## Standard
28	+
29	+	All left-clicks on the gutter act when you press the mouse button down.
30	+
31	+	## Extended
32	+
33	+	All left-clicks on the gutter act when you release the mouse button. This mode allows the mouse to select text while being over the gutter.
34	+
35	+	- Mouse pressed down and moved (either to other line, or into the text area), will make a selection. No action will be taken on when the mouse is released
36	+	- Mouse pressed and released without moving it, will execute the normal gutter click action (breakpoint/fold)
37	+
38	+	## Extended, right only (only in Lazarus 1.5)
39	+
40	+	The Gutter-parts close to the text (line-numbers, change-indicator, and fold) act as describe in extended. The others act as described in standard.
41	+
42	+	## Use line numbers to select lines (only in Lazarus 1.5)
43	+
44	+	Independent of the above setting. the gutter part showing the line numbers will always select the current line (mouse down), and additional full lines on mouse move.
45	+
46	+	This selects in line-mode and can not be used to select part of a line by moving the mouse over the text area. To be able to start a normal selection (select any part of the line), use the "extended" setting above.
47	+
48	+	# Text-area
49	+
50	+	## Right mouse includes caret move
51	+
52	+	Right mouse always triggers the context Menu. Setting the caret to the click location is optional.
53	+
54	+	## Drag Selection
55	+
56	+	You can use the left mouse button to drag an existing selection to a new location in the text. Hold ctrl while dragging to make a copy.
57	+
58	+	## Options no longer present (moved) in Lazarus 1.0
59	+
60	+	### Alt-Key set column mode
61	+
62	+	Use the entry Select text (Columns) from the drop down (for alt-button)
63	+
64	+	If you use the left mouse button, then the dropdown for shift-alt-button will offer Continue Select text (Columns) (Bound to Alt)
65	+
66	+	### Double click selects line
67	+
68	+	Use the drop downs in the "Left2" page
69	+
70	+	## Actions for each mouse button
71	+
72	+	![](/wiki-images/a/a8/IDE_Options_mouse_choose_button.png)
73	+
74	+	The dialog provides a setup page for each mouse button.
75	+
76	+	Left, Left2
77	+	The main button of a mouse.
78	+
79	+	Right
80	+	The 2nd button of a mouse. (also known as context menu button)
81	+
82	+	Middle
83	+	Usually triggered by pressing (instead of turning) the wheel
84	+
85	+	Extra1, Extra2
86	+	Only for 5 button mouses
87	+
88	+	Wheel
89	+	Actions for turning the wheel
90	+
91	+	Each page provides a list of actions for the indicated mouse button, with or without modifier keys.
92	+
93	+	- The left-button without any modifier is fixed as "select text" and can not be modified.
94	+	- Double and triple click is only supported for the left button (page "Left2").
95	+
96	+	The modifier Keys must be an exact match. If "Ctrl-Button" is configured, then other combinations like ctrl-alt-button or ctrl-shift-button will not trigger this configuration.
97	+
98	+	- However there is an exception, if all combinations containing alt for this button are set to "Nothing/Default" then ctrl-alt-button will be treated as ctrl-button.
99	+	- If all combinations of ctrl, alt and shift are set to "Nothing/Default" then they modifier keys will be ignored for this button, and the button always triggers the action set on the no-modifier-key dropdown.
100	+	- On some OS certain combinations of modifier key with specific buttons, may be handled by the OS, and are not available.
101	+
102	+	Nothing/Default
103	+	No action, or action without modifier key
104	+
105	+	Select text
106	+	Selects text. An existing selection will be lost.
107	+
108	+	Select text (Columns)
109	+	Selects text in column mode. An existing selection will be lost.
110	+
111	+	Select text (Lines)
112	+	Selects text, full lines only. An existing selection will be lost.
113	+
114	+	Select current Word
115	+	Selects one word.
116	+
117	+	Select current Line (Text)
118	+	Selects one line, without leading/trailing spaces.
119	+
120	+	Select current Line (Full)
121	+	Selects one line, with leading/trailing spaces
122	+
123	+	Select current Paragraph
124	+	Selects one paragraph. Bound by empty lines.
125	+
126	+	Paste
127	+	Inserts the current selection. If there is no selection, then it depends on the OS, may insert (secondary) clipboard, or do nothing.
128	+
129	+	Jumps to implementation
130	+	Navigates pascal source via codetools. (Find implementation of identifier)
131	+
132	+	Jumps to implementation/other block end
133	+	Navigates pascal source... Also jumps between matching begin/end pairs
134	+
135	+	Add history point
136	+	Add your own History point (normally done by implementation jumps.
137	+
138	+	History back
139	+	Navigate to previous source location.
140	+
141	+	History forward
142	+	If you navigated back in history, go forward again.
143	+
144	+	Set free bookmark
145	+	Sets an available bookmark
146	+
147	+	Reset zoom
148	+	See mouse wheel, sets editor font size to default
149	+
150	+	Context Menu
151	+	normal editor context menu.
152	+
153	+	Context Menu (debug)
154	+	debug section from editor context menu.
155	+
156	+	Context Menu (tab)
157	+	Context menu for editor tabs (trigger anywhere in the editor area)
158	+
159	+	The following are only available for the shift-left-button with or without alt or ctrl. If the left button (with or without alt or ctrl) is set to "select text" (or "select text (Columns/Line)") then one extra entry is listed as first entry in the dropdown. The entry allows to continue (extend) an existing selection. The entry will be one of the following:
160	+
161	+	Continue Select text
162	+
163	+	Continue Select text (Columns/Line)
164	+
165	+	Continue Select text (...) (Bound to Alt,Ctrl Button)
166	+	Continue/Extend an existing selection, using the same selection mode as the button without shift
167	+
168	+	### Actions for mouse wheel
169	+
170	+	The wheel can be set to scroll, at different speeds, or change the editor font size (zoom)
171	+
172	+	Normal scroll is vertical,but automatically changes to horizontal, if the editor has no horizontal scroll bar (to few line). Horizontal can be enforced.
173	+
174	+	### More about: Jumps to implementation/other block end
175	+
176	+	by default, if you click on any identifier such as a function, variable or type name the IDE will jump to the declaration of this identifier (even into another unit).
177	+
178	+	This is the same feature that is available as key-shortcut (usually `Alt`+`Up`). See "Key Mapping" / "Codetools" / "Find declaration"
179	+
180	+	"other block end" means that if you are not over an identifier, but instead over a "begin", "end" or matching brackets or similar then the jump will go to the matching word/bracket. On the Keyboard this is `Ctrl`+`Q`+`K`. See also: "Key Mapping" / "Codetools" / "Find block other end")
181	+
182	+	# Advanced Options
183	+
184	+	For advanced options please see here: [[IDE Window: EditorMouseOptionsAdvanced\|Advanced Mouse Options]]
185	+
186	+	Once you have made changes in the advanced settings, this page will show a warning that it does not represent your settings any more.
187	+
188	+	In this case it also will no longer just follow the changes you make. Instead it will display a button which you must use to override the settings you made in the advanced page. A warning will be shown, if you have unsaved changes.
189	+
190	+	---
191	+	From the Free Pascal wiki, page "IDE Window: Editor Options Mouse", as it stood on 2021-01-30 after a change by FTurtle, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history