Mercurial > vim
annotate runtime/doc/gui.txt @ 19444:a94d27943c93
Added tag v8.2.0279 for changeset 6b1a59e71f850ca81471501424eec4e0171e5012
author | Bram Moolenaar <Bram@vim.org> |
---|---|
date | Wed, 19 Feb 2020 16:00:05 +0100 |
parents | ccd16426a1f9 |
children | 22f0dda71638 |
rev | line source |
---|---|
18879 | 1 *gui.txt* For Vim version 8.2. Last change: 2019 Nov 16 |
7 | 2 |
3 | |
4 VIM REFERENCE MANUAL by Bram Moolenaar | |
5 | |
6 | |
7 Vim's Graphical User Interface *gui* *GUI* | |
8 | |
9 1. Starting the GUI |gui-start| | |
10 2. Scrollbars |gui-scrollbars| | |
11 3. Mouse Control |gui-mouse| | |
12 4. Making GUI Selections |gui-selections| | |
13 5. Menus |menus| | |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
14 6. Font |gui-font| |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
15 7. Extras |gui-extras| |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
16 8. Shell Commands |gui-shell| |
7 | 17 |
18 Other GUI documentation: | |
19 |gui_x11.txt| For specific items of the X11 GUI. | |
20 |gui_w32.txt| For specific items of the Win32 GUI. | |
21 | |
22 | |
23 ============================================================================== | |
24 1. Starting the GUI *gui-start* *E229* *E233* | |
25 | |
26 First you must make sure you actually have a version of Vim with the GUI code | |
694 | 27 included. You can check this with the ":version" command, it says "with xxx |
8218
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
28 GUI", where "xxx" is X11-Motif, X11-Athena, Photon, GTK2, GTK3, etc., or |
694 | 29 "MS-Windows 32 bit GUI version". |
7 | 30 |
31 How to start the GUI depends on the system used. Mostly you can run the | |
32 GUI version of Vim with: | |
33 gvim [options] [files...] | |
34 | |
35 The X11 version of Vim can run both in GUI and in non-GUI mode. See | |
36 |gui-x11-start|. | |
37 | |
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
38 *gui-init* *gvimrc* *.gvimrc* *_gvimrc* *$MYGVIMRC* |
819 | 39 The gvimrc file is where GUI-specific startup commands should be placed. It |
40 is always sourced after the |vimrc| file. If you have one then the $MYGVIMRC | |
41 environment variable has its name. | |
42 | |
7 | 43 When the GUI starts up initializations are carried out, in this order: |
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
44 - The 'term' option is set to "builtin_gui" and terminal options are reset to |
667 | 45 their default value for the GUI |terminal-options|. |
7 | 46 - If the system menu file exists, it is sourced. The name of this file is |
47 normally "$VIMRUNTIME/menu.vim". You can check this with ":version". Also | |
48 see |$VIMRUNTIME|. To skip loading the system menu include 'M' in | |
49 'guioptions'. *buffers-menu* *no_buffers_menu* | |
50 The system menu file includes a "Buffers" menu. If you don't want this, set | |
51 the "no_buffers_menu" variable in your .vimrc (not .gvimrc!): > | |
52 :let no_buffers_menu = 1 | |
53 < NOTE: Switching on syntax highlighting also loads the menu file, thus | |
54 disabling the Buffers menu must be done before ":syntax on". | |
55 The path names are truncated to 35 characters. You can truncate them at a | |
56 different length, for example 50, like this: > | |
57 :let bmenu_max_pathlen = 50 | |
58 - If the "-U {gvimrc}" command-line option has been used when starting Vim, | |
59 the {gvimrc} file will be read for initializations. The following | |
42 | 60 initializations are skipped. When {gvimrc} is "NONE" no file will be read |
61 for initializations. | |
7 | 62 - For Unix and MS-Windows, if the system gvimrc exists, it is sourced. The |
63 name of this file is normally "$VIM/gvimrc". You can check this with | |
64 ":version". Also see |$VIM|. | |
65 - The following are tried, and only the first one that exists is used: | |
66 - If the GVIMINIT environment variable exists and is not empty, it is | |
67 executed as an Ex command. | |
68 - If the user gvimrc file exists, it is sourced. The name of this file is | |
69 normally "$HOME/.gvimrc". You can check this with ":version". | |
12254 | 70 - For Win32, $HOME is set by Vim if needed, see |$HOME-windows|. |
7 | 71 - When a "_gvimrc" file is not found, ".gvimrc" is tried too. And vice |
72 versa. | |
819 | 73 The name of the first file found is stored in $MYGVIMRC, unless it was |
74 already set. | |
7 | 75 - If the 'exrc' option is set (which is NOT the default) the file ./.gvimrc |
76 is sourced, if it exists and isn't the same file as the system or user | |
77 gvimrc file. If this file is not owned by you, some security restrictions | |
78 apply. When ".gvimrc" is not found, "_gvimrc" is tried too. For Macintosh | |
79 and DOS/Win32 "_gvimrc" is tried first. | |
80 | |
81 NOTE: All but the first one are not carried out if Vim was started with | |
11763
21f3930dfe6e
Documentation updates.
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
82 "-u NONE" or "-u DEFAULTS" and no "-U" argument was given, or when started |
21f3930dfe6e
Documentation updates.
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
83 with "-U NONE". |
7 | 84 |
85 All this happens AFTER the normal Vim initializations, like reading your | |
86 .vimrc file. See |initialization|. | |
87 But the GUI window is only opened after all the initializations have been | |
88 carried out. If you want some commands to be executed just after opening the | |
89 GUI window, use the |GUIEnter| autocommand event. Example: > | |
465 | 90 :autocmd GUIEnter * winpos 100 50 |
7 | 91 |
92 You can use the gvimrc files to set up your own customized menus (see |:menu|) | |
93 and initialize other things that you may want to set up differently from the | |
94 terminal version. | |
95 | |
96 Recommended place for your personal GUI initializations: | |
4863
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
97 Unix $HOME/.gvimrc or $HOME/.vim/gvimrc |
18912
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
98 Win32 $HOME/_gvimrc, $HOME/vimfiles/gvimrc |
4863
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
99 or $VIM/_gvimrc |
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
100 Amiga s:.gvimrc, home:.gvimrc, home:vimfiles:gvimrc |
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
101 or $VIM/.gvimrc |
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
102 |
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
103 The personal initialization files are searched in the order specified above |
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
104 and only the first one that is found is read. |
7 | 105 |
106 There are a number of options which only have meaning in the GUI version of | |
107 Vim. These are 'guicursor', 'guifont', 'guipty' and 'guioptions'. They are | |
108 documented in |options.txt| with all the other options. | |
109 | |
862 | 110 If using the Motif or Athena version of the GUI (but not for the GTK+ or |
11 | 111 Win32 version), a number of X resources are available. See |gui-resources|. |
7 | 112 |
113 Another way to set the colors for different occasions is with highlight | |
114 groups. The "Normal" group is used to set the background and foreground | |
115 colors. Example (which looks nice): > | |
116 | |
117 :highlight Normal guibg=grey90 | |
118 | |
119 The "guibg" and "guifg" settings override the normal background and | |
120 foreground settings. The other settings for the Normal highlight group are | |
121 not used. Use the 'guifont' option to set the font. | |
122 | |
123 Also check out the 'guicursor' option, to set the colors for the cursor in | |
124 various modes. | |
125 | |
126 Vim tries to make the window fit on the screen when it starts up. This avoids | |
127 that you can't see part of it. On the X Window System this requires a bit of | |
128 guesswork. You can change the height that is used for the window title and a | |
129 task bar with the 'guiheadroom' option. | |
130 | |
131 *:winp* *:winpos* *E188* | |
132 :winp[os] | |
133 Display current position of the top left corner of the GUI vim | |
134 window in pixels. Does not work in all versions. | |
13437 | 135 Also see |getwinpos()|, |getwinposx()| and |getwinposy()|. |
7 | 136 |
137 :winp[os] {X} {Y} *E466* | |
138 Put the GUI vim window at the given {X} and {Y} coordinates. | |
139 The coordinates should specify the position in pixels of the | |
140 top left corner of the window. Does not work in all versions. | |
141 Does work in an (new) xterm |xterm-color|. | |
142 When the GUI window has not been opened yet, the values are | |
143 remembered until the window is opened. The position is | |
144 adjusted to make the window fit on the screen (if possible). | |
145 | |
146 *:win* *:winsize* *E465* | |
147 :win[size] {width} {height} | |
148 Set the window height to {width} by {height} characters. | |
149 Obsolete, use ":set lines=11 columns=22". | |
150 If you get less lines than expected, check the 'guiheadroom' | |
151 option. | |
152 | |
153 If you are running the X Window System, you can get information about the | |
5697 | 154 window Vim is running in with these commands: > |
7 | 155 :!xwininfo -id $WINDOWID |
5697 | 156 :!xprop -id $WINDOWID |
157 :execute '!xwininfo -id ' . v:windowid | |
158 :execute '!xprop -id ' . v:windowid | |
3082 | 159 < |
160 *gui-IME* *iBus* | |
161 Input methods for international characters in X that rely on the XIM | |
162 framework, most notably iBus, have been known to produce undesirable results | |
12785 | 163 in gvim. These may include an inability to enter spaces, or long delays |
3082 | 164 between typing a character and it being recognized by the application. |
165 | |
166 One workaround that has been successful, for unknown reasons, is to prevent | |
167 gvim from forking into the background by starting it with the |-f| argument. | |
7 | 168 |
169 ============================================================================== | |
170 2. Scrollbars *gui-scrollbars* | |
171 | |
98 | 172 There are vertical scrollbars and a horizontal scrollbar. You may |
7 | 173 configure which ones appear with the 'guioptions' option. |
174 | |
175 The interface looks like this (with ":set guioptions=mlrb"): | |
176 | |
2642 | 177 +------------------------------+ ` |
178 | File Edit Help | <- Menu bar (m) ` | |
179 +-+--------------------------+-+ ` | |
180 |^| |^| ` | |
181 |#| Text area. |#| ` | |
182 | | | | ` | |
183 |v|__________________________|v| ` | |
184 Normal status line -> |-+ File.c 5,2 +-| ` | |
185 between Vim windows |^|""""""""""""""""""""""""""|^| ` | |
186 | | | | ` | |
187 | | Another file buffer. | | ` | |
188 | | | | ` | |
189 |#| |#| ` | |
190 Left scrollbar (l) -> |#| |#| <- Right ` | |
191 |#| |#| scrollbar (r) ` | |
192 | | | | ` | |
193 |v| |v| ` | |
194 +-+--------------------------+-+ ` | |
195 | |< #### >| | <- Bottom ` | |
196 +-+--------------------------+-+ scrollbar (b) ` | |
7 | 197 |
198 Any of the scrollbar or menu components may be turned off by not putting the | |
199 appropriate letter in the 'guioptions' string. The bottom scrollbar is | |
200 only useful when 'nowrap' is set. | |
201 | |
202 | |
203 VERTICAL SCROLLBARS *gui-vert-scroll* | |
204 | |
205 Each Vim window has a scrollbar next to it which may be scrolled up and down | |
206 to move through the text in that buffer. The size of the scrollbar-thumb | |
207 indicates the fraction of the buffer which can be seen in the window. | |
208 When the scrollbar is dragged all the way down, the last line of the file | |
209 will appear in the top of the window. | |
210 | |
211 If a window is shrunk to zero height (by the growth of another window) its | |
236 | 212 scrollbar disappears. It reappears when the window is restored. |
7 | 213 |
214 If a window is vertically split, it will get a scrollbar when it is the | |
215 current window and when, taking the middle of the current window and drawing a | |
216 vertical line, this line goes through the window. | |
217 When there are scrollbars on both sides, and the middle of the current window | |
218 is on the left half, the right scrollbar column will contain scrollbars for | |
219 the rightmost windows. The same happens on the other side. | |
220 | |
221 | |
222 HORIZONTAL SCROLLBARS *gui-horiz-scroll* | |
223 | |
224 The horizontal scrollbar (at the bottom of the Vim GUI) may be used to | |
225 scroll text sideways when the 'wrap' option is turned off. The | |
226 scrollbar-thumb size is such that the text of the longest visible line may be | |
227 scrolled as far as possible left and right. The cursor is moved when | |
228 necessary, it must remain on a visible character (unless 'virtualedit' is | |
229 set). | |
230 | |
98 | 231 Computing the length of the longest visible line takes quite a bit of |
232 computation, and it has to be done every time something changes. If this | |
233 takes too much time or you don't like the cursor jumping to another line, | |
234 include the 'h' flag in 'guioptions'. Then the scrolling is limited by the | |
235 text of the current cursor line. | |
7 | 236 |
237 *athena-intellimouse* | |
238 If you have an Intellimouse and an X server that supports using the wheel, | |
239 then you can use the wheel to scroll the text up and down in gvim. This works | |
240 with XFree86 4.0 and later, and with some older versions when you add patches. | |
241 See |scroll-mouse-wheel|. | |
242 | |
243 For older versions of XFree86 you must patch your X server. The following | |
244 page has a bit of information about using the Intellimouse on Linux as well as | |
245 links to the patches and X server binaries (may not have the one you need | |
246 though): | |
247 http://www.inria.fr/koala/colas/mouse-wheel-scroll/ | |
248 | |
249 ============================================================================== | |
250 3. Mouse Control *gui-mouse* | |
251 | |
252 The mouse only works if the appropriate flag in the 'mouse' option is set. | |
253 When the GUI is switched on, and 'mouse' wasn't set yet, the 'mouse' option is | |
254 automatically set to "a", enabling it for all modes except for the | |
255 |hit-enter| prompt. If you don't want this, a good place to change the | |
256 'mouse' option is the "gvimrc" file. | |
257 | |
258 Other options that are relevant: | |
259 'mousefocus' window focus follows mouse pointer |gui-mouse-focus| | |
260 'mousemodel' what mouse button does which action | |
261 'mousehide' hide mouse pointer while typing text | |
262 'selectmode' whether to start Select mode or Visual mode | |
263 | |
264 A quick way to set these is with the ":behave" command. | |
265 *:behave* *:be* | |
266 :be[have] {model} Set behavior for mouse and selection. Valid | |
267 arguments are: | |
268 mswin MS-Windows behavior | |
269 xterm Xterm behavior | |
270 | |
271 Using ":behave" changes these options: | |
272 option mswin xterm ~ | |
273 'selectmode' "mouse,key" "" | |
274 'mousemodel' "popup" "extend" | |
275 'keymodel' "startsel,stopsel" "" | |
276 'selection' "exclusive" "inclusive" | |
277 | |
278 In the $VIMRUNTIME directory, there is a script called |mswin.vim|, which will | |
279 also map a few keys to the MS-Windows cut/copy/paste commands. This is NOT | |
280 compatible, since it uses the CTRL-V, CTRL-X and CTRL-C keys. If you don't | |
281 mind, use this command: > | |
282 :so $VIMRUNTIME/mswin.vim | |
283 | |
284 For scrolling with a wheel on a mouse, see |scroll-mouse-wheel|. | |
285 | |
286 | |
287 3.1 Moving Cursor with Mouse *gui-mouse-move* | |
288 | |
289 Click the left mouse button somewhere in a text buffer where you want the | |
290 cursor to go, and it does! | |
291 This works in when 'mouse' contains ~ | |
292 Normal mode 'n' or 'a' | |
293 Visual mode 'v' or 'a' | |
294 Insert mode 'i' or 'a' | |
295 | |
296 Select mode is handled like Visual mode. | |
297 | |
298 You may use this with an operator such as 'd' to delete text from the current | |
299 cursor position to the position you point to with the mouse. That is, you hit | |
300 'd' and then click the mouse somewhere. | |
301 | |
302 *gui-mouse-focus* | |
303 The 'mousefocus' option can be set to make the keyboard focus follow the | |
304 mouse pointer. This means that the window where the mouse pointer is, is the | |
305 active window. Warning: this doesn't work very well when using a menu, | |
306 because the menu command will always be applied to the top window. | |
307 | |
308 If you are on the ':' line (or '/' or '?'), then clicking the left or right | |
309 mouse button will position the cursor on the ':' line (if 'mouse' contains | |
18639 | 310 'c' or 'a'). |
7 | 311 |
312 In any situation the middle mouse button may be clicked to paste the current | |
313 selection. | |
314 | |
315 | |
316 3.2 Selection with Mouse *gui-mouse-select* | |
317 | |
318 The mouse can be used to start a selection. How depends on the 'mousemodel' | |
319 option: | |
320 'mousemodel' is "extend": use the right mouse button | |
321 'mousemodel' is "popup": use the left mouse button, while keeping the Shift | |
322 key pressed. | |
323 | |
324 If there was no selection yet, this starts a selection from the old cursor | |
325 position to the position pointed to with the mouse. If there already is a | |
326 selection then the closest end will be extended. | |
327 | |
328 If 'selectmode' contains "mouse", then the selection will be in Select mode. | |
329 This means that typing normal text will replace the selection. See | |
330 |Select-mode|. Otherwise, the selection will be in Visual mode. | |
331 | |
332 Double clicking may be done to make the selection word-wise, triple clicking | |
333 makes it line-wise, and quadruple clicking makes it rectangular block-wise. | |
334 | |
335 See |gui-selections| on how the selection is used. | |
336 | |
337 | |
338 3.3 Other Text Selection with Mouse *gui-mouse-modeless* | |
339 *modeless-selection* | |
340 A different kind of selection is used when: | |
341 - in Command-line mode | |
342 - in the Command-line window and pointing in another window | |
343 - at the |hit-enter| prompt | |
344 - whenever the current mode is not in the 'mouse' option | |
345 - when holding the CTRL and SHIFT keys in the GUI | |
1619 | 346 |
7 | 347 Since Vim continues like the selection isn't there, and there is no mode |
348 associated with the selection, this is called modeless selection. Any text in | |
349 the Vim window can be selected. Select the text by pressing the left mouse | |
350 button at the start, drag to the end and release. To extend the selection, | |
351 use the right mouse button when 'mousemodel' is "extend", or the left mouse | |
352 button with the shift key pressed when 'mousemodel' is "popup". | |
353 The selection is removed when the selected text is scrolled or changed. | |
1619 | 354 |
7 | 355 On the command line CTRL-Y can be used to copy the selection into the |
1619 | 356 clipboard. To do this from Insert mode, use CTRL-O : CTRL-Y <CR>. When |
357 'guioptions' contains a or A (default on X11), the selection is automatically | |
358 copied to the "* register. | |
359 | |
360 The middle mouse button can then paste the text. On non-X11 systems, you can | |
361 use CTRL-R +. | |
7 | 362 |
363 | |
364 3.4 Using Mouse on Status Lines *gui-mouse-status* | |
365 | |
366 Clicking the left or right mouse button on the status line below a Vim | |
367 window makes that window the current window. This actually happens on button | |
368 release (to be able to distinguish a click from a drag action). | |
369 | |
370 With the left mouse button a status line can be dragged up and down, thus | |
371 resizing the windows above and below it. This does not change window focus. | |
372 | |
373 The same can be used on the vertical separator: click to give the window left | |
374 of it focus, drag left and right to make windows wider and narrower. | |
375 | |
376 | |
377 3.5 Various Mouse Clicks *gui-mouse-various* | |
378 | |
379 <S-LeftMouse> Search forward for the word under the mouse click. | |
380 When 'mousemodel' is "popup" this starts or extends a | |
381 selection. | |
382 <S-RightMouse> Search backward for the word under the mouse click. | |
383 <C-LeftMouse> Jump to the tag name under the mouse click. | |
384 <C-RightMouse> Jump back to position before the previous tag jump | |
385 (same as "CTRL-T") | |
386 | |
387 | |
388 3.6 Mouse Mappings *gui-mouse-mapping* | |
389 | |
390 The mouse events, complete with modifiers, may be mapped. Eg: > | |
391 :map <S-LeftMouse> <RightMouse> | |
392 :map <S-LeftDrag> <RightDrag> | |
393 :map <S-LeftRelease> <RightRelease> | |
394 :map <2-S-LeftMouse> <2-RightMouse> | |
395 :map <2-S-LeftDrag> <2-RightDrag> | |
396 :map <2-S-LeftRelease> <2-RightRelease> | |
397 :map <3-S-LeftMouse> <3-RightMouse> | |
398 :map <3-S-LeftDrag> <3-RightDrag> | |
399 :map <3-S-LeftRelease> <3-RightRelease> | |
400 :map <4-S-LeftMouse> <4-RightMouse> | |
401 :map <4-S-LeftDrag> <4-RightDrag> | |
402 :map <4-S-LeftRelease> <4-RightRelease> | |
403 These mappings make selection work the way it probably should in a Motif | |
404 application, with shift-left mouse allowing for extending the visual area | |
405 rather than the right mouse button. | |
406 | |
407 Mouse mapping with modifiers does not work for modeless selection. | |
408 | |
409 | |
410 3.7 Drag and drop *drag-n-drop* | |
411 | |
412 You can drag and drop one or more files into the Vim window, where they will | |
413 be opened as if a |:drop| command was used. | |
414 | |
415 If you hold down Shift while doing this, Vim changes to the first dropped | |
416 file's directory. If you hold Ctrl Vim will always split a new window for the | |
417 file. Otherwise it's only done if the current buffer has been changed. | |
418 | |
419 You can also drop a directory on Vim. This starts the explorer plugin for | |
420 that directory (assuming it was enabled, otherwise you'll get an error | |
421 message). Keep Shift pressed to change to the directory instead. | |
422 | |
423 If Vim happens to be editing a command line, the names of the dropped files | |
424 and directories will be inserted at the cursor. This allows you to use these | |
425 names with any Ex command. Special characters (space, tab, double quote and | |
426 '|'; backslash on non-MS-Windows systems) will be escaped. | |
427 | |
428 ============================================================================== | |
429 4. Making GUI Selections *gui-selections* | |
430 | |
431 *quotestar* | |
432 You may make selections with the mouse (see |gui-mouse-select|), or by using | |
433 Vim's Visual mode (see |v|). If 'a' is present in 'guioptions', then | |
434 whenever a selection is started (Visual or Select mode), or when the selection | |
435 is changed, Vim becomes the owner of the windowing system's primary selection | |
436 (on MS-Windows the |gui-clipboard| is used; under X11, the |x11-selection| is | |
437 used - you should read whichever of these is appropriate now). | |
438 | |
439 *clipboard* | |
440 There is a special register for storing this selection, it is the "* | |
441 register. Nothing is put in here unless the information about what text is | |
236 | 442 selected is about to change (e.g. with a left mouse click somewhere), or when |
7 | 443 another application wants to paste the selected text. Then the text is put |
444 in the "* register. For example, to cut a line and make it the current | |
445 selection/put it on the clipboard: > | |
446 | |
447 "*dd | |
448 | |
449 Similarly, when you want to paste a selection from another application, e.g., | |
450 by clicking the middle mouse button, the selection is put in the "* register | |
451 first, and then 'put' like any other register. For example, to put the | |
452 selection (contents of the clipboard): > | |
453 | |
454 "*p | |
455 | |
456 When using this register under X11, also see |x11-selection|. This also | |
457 explains the related "+ register. | |
458 | |
459 Note that when pasting text from one Vim into another separate Vim, the type | |
460 of selection (character, line, or block) will also be copied. For other | |
461 applications the type is always character. However, if the text gets | |
462 transferred via the |x11-cut-buffer|, the selection type is ALWAYS lost. | |
463 | |
464 When the "unnamed" string is included in the 'clipboard' option, the unnamed | |
465 register is the same as the "* register. Thus you can yank to and paste the | |
466 selection without prepending "* to commands. | |
467 | |
468 ============================================================================== | |
469 5. Menus *menus* | |
470 | |
471 For an introduction see |usr_42.txt| in the user manual. | |
472 | |
473 | |
474 5.1 Using Menus *using-menus* | |
475 | |
476 Basically, menus can be used just like mappings. You can define your own | |
477 menus, as many as you like. | |
478 Long-time Vim users won't use menus much. But the power is in adding your own | |
479 menus and menu items. They are most useful for things that you can't remember | |
480 what the key sequence was. | |
481 | |
482 For creating menus in a different language, see |:menutrans|. | |
12756
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
483 If you don't want to use menus at all, see |'go-M'|. |
7 | 484 |
485 *menu.vim* | |
486 The default menus are read from the file "$VIMRUNTIME/menu.vim". See | |
487 |$VIMRUNTIME| for where the path comes from. You can set up your own menus. | |
488 Starting off with the default set is a good idea. You can add more items, or, | |
489 if you don't like the defaults at all, start with removing all menus | |
490 |:unmenu-all|. You can also avoid the default menus being loaded by adding | |
491 this line to your .vimrc file (NOT your .gvimrc file!): > | |
492 :let did_install_default_menus = 1 | |
493 If you also want to avoid the Syntax menu: > | |
494 :let did_install_syntax_menu = 1 | |
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
495 The first item in the Syntax menu can be used to show all available filetypes |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
496 in the menu (which can take a bit of time to load). If you want to have all |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
497 filetypes already present at startup, add: > |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
498 :let do_syntax_sel_menu = 1 |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
499 |
12804
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
500 The following menuitems show all available color schemes, keymaps and compiler |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
501 settings: |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
502 Edit > Color Scheme ~ |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
503 Edit > Keymap ~ |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
504 Tools > Set Compiler ~ |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
505 However, they can also take a bit of time to load, because they search all |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
506 related files from the directories in 'runtimepath'. Therefore they are |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
507 loaded lazily (by the |CursorHold| event), or you can also load them manually. |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
508 If you want to have all these items already present at startup, add: > |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
509 :let do_no_lazyload_menus = 1 |
6687b321fb91
patch 8.0.1279: initializing menus can be slow
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
510 |
12756
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
511 Note that the menu.vim is sourced when `:syntax on` or `:filetype on` is |
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
512 executed or after your .vimrc file is sourced. This means that the 'encoding' |
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
513 option and the language of messages (`:language messages`) must be set before |
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
514 that (if you want to change them). |
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12559
diff
changeset
|
515 |
7 | 516 *console-menus* |
517 Although this documentation is in the GUI section, you can actually use menus | |
518 in console mode too. You will have to load |menu.vim| explicitly then, it is | |
519 not done by default. You can use the |:emenu| command and command-line | |
520 completion with 'wildmenu' to access the menu entries almost like a real menu | |
521 system. To do this, put these commands in your .vimrc file: > | |
522 :source $VIMRUNTIME/menu.vim | |
523 :set wildmenu | |
524 :set cpo-=< | |
525 :set wcm=<C-Z> | |
526 :map <F4> :emenu <C-Z> | |
527 Pressing <F4> will start the menu. You can now use the cursor keys to select | |
528 a menu entry. Hit <Enter> to execute it. Hit <Esc> if you want to cancel. | |
529 This does require the |+menu| feature enabled at compile time. | |
530 | |
531 *tear-off-menus* | |
8218
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
532 GTK+ 2 and Motif support Tear-off menus. These are sort of sticky menus or |
7 | 533 pop-up menus that are present all the time. If the resizing does not work |
534 correctly, this may be caused by using something like "Vim*geometry" in the | |
535 defaults. Use "Vim.geometry" instead. | |
536 | |
8218
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
537 As to GTK+ 3, tear-off menus have been deprecated since GTK+ 3.4. |
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
538 Accordingly, they are disabled if gvim is linked against GTK+ 3.4 or later. |
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
539 |
7 | 540 The Win32 GUI version emulates Motif's tear-off menus. Actually, a Motif user |
541 will spot the differences easily, but hopefully they're just as useful. You | |
542 can also use the |:tearoff| command together with |hidden-menus| to create | |
543 floating menus that do not appear on the main menu bar. | |
544 | |
545 | |
546 5.2 Creating New Menus *creating-menus* | |
547 | |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
548 *:me* *:menu* *:noreme* *:noremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
549 *:am* *:amenu* *:an* *:anoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
550 *:nme* *:nmenu* *:nnoreme* *:nnoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
551 *:ome* *:omenu* *:onoreme* *:onoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
552 *:vme* *:vmenu* *:vnoreme* *:vnoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
553 *:xme* *:xmenu* *:xnoreme* *:xnoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
554 *:sme* *:smenu* *:snoreme* *:snoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
555 *:ime* *:imenu* *:inoreme* *:inoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
556 *:cme* *:cmenu* *:cnoreme* *:cnoremenu* |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
557 *:tlm* *:tlmenu* *:tln* *:tlnoremenu* |
7 | 558 *E330* *E327* *E331* *E336* *E333* |
1120 | 559 *E328* *E329* *E337* *E792* |
7 | 560 To create a new menu item, use the ":menu" commands. They are mostly like |
18594 | 561 the ":map" set of commands (see |map-modes|), but the first argument is a menu |
562 item name, given as a path of menus and submenus with a '.' between them, | |
563 e.g.: > | |
7 | 564 |
565 :menu File.Save :w<CR> | |
566 :inoremenu File.Save <C-O>:w<CR> | |
567 :menu Edit.Big\ Changes.Delete\ All\ Spaces :%s/[ ^I]//g<CR> | |
568 | |
569 This last one will create a new item in the menu bar called "Edit", holding | |
570 the mouse button down on this will pop up a menu containing the item | |
571 "Big Changes", which is a sub-menu containing the item "Delete All Spaces", | |
572 which when selected, performs the operation. | |
573 | |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
574 To create a menu for terminal mode, use |:tlmenu| instead of |:tmenu| unlike |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
575 key mapping (|:tmap|). This is because |:tmenu| is already used for defining |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
576 tooltips for menus. See |terminal-typing|. |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
577 |
7 | 578 Special characters in a menu name: |
579 | |
580 & The next character is the shortcut key. Make sure each | |
581 shortcut key is only used once in a (sub)menu. If you want to | |
582 insert a literal "&" in the menu name use "&&". | |
583 <Tab> Separates the menu name from right-aligned text. This can be | |
584 used to show the equivalent typed command. The text "<Tab>" | |
585 can be used here for convenience. If you are using a real | |
1235 | 586 tab, don't forget to put a backslash before it! |
7 | 587 Example: > |
588 | |
589 :amenu &File.&Open<Tab>:e :browse e<CR> | |
590 | |
591 [typed literally] | |
592 With the shortcut "F" (while keeping the <Alt> key pressed), and then "O", | |
593 this menu can be used. The second part is shown as "Open :e". The ":e" | |
594 is right aligned, and the "O" is underlined, to indicate it is the shortcut. | |
595 | |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
596 The ":amenu" command can be used to define menu entries for all modes at once, |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
597 except for Terminal mode. To make the command work correctly, a character is |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
598 automatically inserted for some modes: |
7 | 599 mode inserted appended ~ |
600 Normal nothing nothing | |
601 Visual <C-C> <C-\><C-G> | |
2152 | 602 Insert <C-\><C-O> |
7 | 603 Cmdline <C-C> <C-\><C-G> |
604 Op-pending <C-C> <C-\><C-G> | |
605 | |
606 Appending CTRL-\ CTRL-G is for going back to insert mode when 'insertmode' is | |
607 set. |CTRL-\_CTRL-G| | |
608 | |
609 Example: > | |
610 | |
611 :amenu File.Next :next^M | |
612 | |
613 is equal to: > | |
614 | |
615 :nmenu File.Next :next^M | |
616 :vmenu File.Next ^C:next^M^\^G | |
2152 | 617 :imenu File.Next ^\^O:next^M |
7 | 618 :cmenu File.Next ^C:next^M^\^G |
619 :omenu File.Next ^C:next^M^\^G | |
620 | |
621 Careful: In Insert mode this only works for a SINGLE Normal mode command, | |
622 because of the CTRL-O. If you have two or more commands, you will need to use | |
623 the ":imenu" command. For inserting text in any mode, you can use the | |
624 expression register: > | |
625 | |
626 :amenu Insert.foobar "='foobar'<CR>P | |
627 | |
628 Note that the '<' and 'k' flags in 'cpoptions' also apply here (when | |
629 included they make the <> form and raw key codes not being recognized). | |
630 | |
631 Note that <Esc> in Cmdline mode executes the command, like in a mapping. This | |
632 is Vi compatible. Use CTRL-C to quit Cmdline mode. | |
633 | |
634 *:menu-<silent>* *:menu-silent* | |
635 To define a menu which will not be echoed on the command line, add | |
636 "<silent>" as the first argument. Example: > | |
637 :menu <silent> Settings.Ignore\ case :set ic<CR> | |
638 The ":set ic" will not be echoed when using this menu. Messages from the | |
639 executed command are still given though. To shut them up too, add a ":silent" | |
640 in the executed command: > | |
641 :menu <silent> Search.Header :exe ":silent normal /Header\r"<CR> | |
859 | 642 "<silent>" may also appear just after "<special>" or "<script>". |
643 | |
644 *:menu-<special>* *:menu-special* | |
645 Define a menu with <> notation for special keys, even though the "<" flag | |
646 may appear in 'cpoptions'. This is useful if the side effect of setting | |
647 'cpoptions' is not desired. Example: > | |
648 :menu <special> Search.Header /Header<CR> | |
649 "<special>" must appear as the very first argument to the ":menu" command or | |
650 just after "<silent>" or "<script>". | |
651 | |
7 | 652 *:menu-<script>* *:menu-script* |
653 The "to" part of the menu will be inspected for mappings. If you don't want | |
654 this, use the ":noremenu" command (or the similar one for a specific mode). | |
655 If you do want to use script-local mappings, add "<script>" as the very first | |
859 | 656 argument to the ":menu" command or just after "<silent>" or "<special>". |
7 | 657 |
658 *menu-priority* | |
659 You can give a priority to a menu. Menus with a higher priority go more to | |
660 the right. The priority is given as a number before the ":menu" command. | |
661 Example: > | |
662 :80menu Buffer.next :bn<CR> | |
663 | |
664 The default menus have these priorities: | |
665 File 10 | |
666 Edit 20 | |
667 Tools 40 | |
668 Syntax 50 | |
669 Buffers 60 | |
670 Window 70 | |
671 Help 9999 | |
672 | |
673 When no or zero priority is given, 500 is used. | |
674 The priority for the PopUp menu is not used. | |
675 | |
676 The Help menu will be placed on the far right side of the menu bar on systems | |
8218
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
677 which support this (Motif and GTK+). For GTK+ 2 and 3, this is not done |
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
678 anymore because right-aligning the Help menu is now discouraged UI design. |
7 | 679 |
680 You can use a priority higher than 9999, to make it go after the Help menu, | |
681 but that is non-standard and is discouraged. The highest possible priority is | |
682 about 32000. The lowest is 1. | |
683 | |
684 *sub-menu-priority* | |
685 The same mechanism can be used to position a sub-menu. The priority is then | |
686 given as a dot-separated list of priorities, before the menu name: > | |
687 :menu 80.500 Buffer.next :bn<CR> | |
688 Giving the sub-menu priority is only needed when the item is not to be put | |
689 in a normal position. For example, to put a sub-menu before the other items: > | |
690 :menu 80.100 Buffer.first :brew<CR> | |
691 Or to put a sub-menu after the other items, and further items with default | |
692 priority will be put before it: > | |
693 :menu 80.900 Buffer.last :blast<CR> | |
694 When a number is missing, the default value 500 will be used: > | |
695 :menu .900 myMenu.test :echo "text"<CR> | |
696 The menu priority is only used when creating a new menu. When it already | |
697 existed, e.g., in another mode, the priority will not change. Thus, the | |
698 priority only needs to be given the first time a menu is used. | |
699 An exception is the PopUp menu. There is a separate menu for each mode | |
700 (Normal, Op-pending, Visual, Insert, Cmdline). The order in each of these | |
701 menus can be different. This is different from menu-bar menus, which have | |
702 the same order for all modes. | |
703 NOTE: sub-menu priorities currently don't work for all versions of the GUI. | |
704 | |
705 *menu-separator* *E332* | |
706 Menu items can be separated by a special item that inserts some space between | |
707 items. Depending on the system this is displayed as a line or a dotted line. | |
708 These items must start with a '-' and end in a '-'. The part in between is | |
709 used to give it a unique name. Priorities can be used as with normal items. | |
710 Example: > | |
711 :menu Example.item1 :do something | |
712 :menu Example.-Sep- : | |
713 :menu Example.item2 :do something different | |
714 Note that the separator also requires a rhs. It doesn't matter what it is, | |
715 because the item will never be selected. Use a single colon to keep it | |
716 simple. | |
717 | |
718 *gui-toolbar* | |
11 | 719 The toolbar is currently available in the Win32, Athena, Motif, GTK+ (X11), |
862 | 720 and Photon GUI. It should turn up in other GUIs in due course. The |
236 | 721 default toolbar is setup in menu.vim. |
722 The display of the toolbar is controlled by the 'guioptions' letter 'T'. You | |
7 | 723 can thus have menu & toolbar together, or either on its own, or neither. |
2207
b17bbfa96fa0
Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
724 The appearance is controlled by the 'toolbar' option. You can choose between |
7 | 725 an image, text or both. |
726 | |
727 *toolbar-icon* | |
728 The toolbar is defined as a special menu called ToolBar, which only has one | |
729 level. Vim interprets the items in this menu as follows: | |
730 1) If an "icon=" argument was specified, the file with this name is used. | |
731 The file can either be specified with the full path or with the base name. | |
732 In the last case it is searched for in the "bitmaps" directory in | |
236 | 733 'runtimepath', like in point 3. Examples: > |
7 | 734 :amenu icon=/usr/local/pixmaps/foo_icon.xpm ToolBar.Foo :echo "Foo"<CR> |
735 :amenu icon=FooIcon ToolBar.Foo :echo "Foo"<CR> | |
736 < Note that in the first case the extension is included, while in the second | |
737 case it is omitted. | |
738 If the file cannot be opened the next points are tried. | |
739 A space in the file name must be escaped with a backslash. | |
740 A menu priority must come _after_ the icon argument: > | |
741 :amenu icon=foo 1.42 ToolBar.Foo :echo "42!"<CR> | |
742 2) An item called 'BuiltIn##', where ## is a number, is taken as number ## of | |
236 | 743 the built-in bitmaps available in Vim. Currently there are 31 numbered |
7 | 744 from 0 to 30 which cover most common editing operations |builtin-tools|. > |
745 :amenu ToolBar.BuiltIn22 :call SearchNext("back")<CR> | |
746 3) An item with another name is first searched for in the directory | |
747 "bitmaps" in 'runtimepath'. If found, the bitmap file is used as the | |
748 toolbar button image. Note that the exact filename is OS-specific: For | |
749 example, under Win32 the command > | |
750 :amenu ToolBar.Hello :echo "hello"<CR> | |
751 < would find the file 'hello.bmp'. Under GTK+/X11 it is 'Hello.xpm'. With | |
752 GTK+ 2 the files 'Hello.png', 'Hello.xpm' and 'Hello.bmp' are checked for | |
753 existence, and the first one found would be used. | |
754 For MS-Windows and GTK+ 2 the bitmap is scaled to fit the button. For | |
755 MS-Windows a size of 18 by 18 pixels works best. | |
756 For MS-Windows the bitmap should have 16 colors with the standard palette. | |
757 The light grey pixels will be changed to the Window frame color and the | |
758 dark grey pixels to the window shadow color. More colors might also work, | |
759 depending on your system. | |
760 4) If the bitmap is still not found, Vim checks for a match against its list | |
761 of built-in names. Each built-in button image has a name. | |
762 So the command > | |
763 :amenu ToolBar.Open :e | |
764 < will show the built-in "open a file" button image if no open.bmp exists. | |
765 All the built-in names can be seen used in menu.vim. | |
766 5) If all else fails, a blank, but functioning, button is displayed. | |
767 | |
768 *builtin-tools* | |
769 nr Name Normal action ~ | |
770 00 New open new window | |
771 01 Open browse for file to open in current window | |
772 02 Save write buffer to file | |
773 03 Undo undo last change | |
774 04 Redo redo last undone change | |
775 05 Cut delete selected text to clipboard | |
776 06 Copy copy selected text to clipboard | |
777 07 Paste paste text from clipboard | |
778 08 Print print current buffer | |
779 09 Help open a buffer on Vim's builtin help | |
780 10 Find start a search command | |
781 11 SaveAll write all modified buffers to file | |
782 12 SaveSesn write session file for current situation | |
783 13 NewSesn write new session file | |
784 14 LoadSesn load session file | |
785 15 RunScript browse for file to run as a Vim script | |
786 16 Replace prompt for substitute command | |
787 17 WinClose close current window | |
788 18 WinMax make current window use many lines | |
789 19 WinMin make current window use few lines | |
790 20 WinSplit split current window | |
791 21 Shell start a shell | |
792 22 FindPrev search again, backward | |
793 23 FindNext search again, forward | |
794 24 FindHelp prompt for word to search help for | |
795 25 Make run make and jump to first error | |
796 26 TagJump jump to tag under the cursor | |
797 27 RunCtags build tags for files in current directory | |
798 28 WinVSplit split current window vertically | |
799 29 WinMaxWidth make current window use many columns | |
800 30 WinMinWidth make current window use few columns | |
801 | |
802 *hidden-menus* *win32-hidden-menus* | |
803 In the Win32 and GTK+ GUI, starting a menu name with ']' excludes that menu | |
804 from the main menu bar. You must then use the |:popup| or |:tearoff| command | |
805 to display it. | |
806 | |
12499 | 807 *window-toolbar* *WinBar* |
12487
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
808 Each window can have a local toolbar. This uses the first line of the window, |
12499 | 809 thus reduces the space for the text by one line. The items in the toolbar |
810 must start with "WinBar". | |
12487
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
811 |
12499 | 812 Only text can be used. When using Unicode, special characters can be used to |
12487
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
813 make the items look like icons. |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
814 |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
815 If the items do not fit then the last ones cannot be used. The toolbar does |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
816 not wrap. |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
817 |
12559 | 818 Note that Vim may be in any mode when executing these commands. The menu |
819 should be defined for Normal mode and will be executed without changing the | |
820 current mode. Thus if the current window is in Visual mode and the menu | |
821 command does not intentionally change the mode, Vim will remain in Visual | |
822 mode. Best is to use `:nnoremenu` to avoid side effects. | |
823 | |
12487
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
824 Example for debugger tools: > |
12559 | 825 nnoremenu 1.10 WinBar.Step :Step<CR> |
826 nnoremenu 1.20 WinBar.Next :Next<CR> | |
827 nnoremenu 1.30 WinBar.Finish :Finish<CR> | |
828 nnoremenu 1.40 WinBar.Cont :Continue<CR> | |
12487
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
829 < |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
830 The window toolbar uses the ToolbarLine and ToolbarButton highlight groups. |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
831 |
12499 | 832 When splitting the window the window toolbar is not copied to the new window. |
833 | |
7 | 834 *popup-menu* |
862 | 835 In the Win32, GTK+, Motif, Athena and Photon GUI, you can define the |
434 | 836 special menu "PopUp". This is the menu that is displayed when the right mouse |
837 button is pressed, if 'mousemodel' is set to popup or popup_setpos. | |
12487
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
838 Example: > |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
839 nnoremenu 1.40 PopUp.&Paste "+gP |
3f16cf18386c
patch 8.0.1123: cannot define a toolbar for a window
Christian Brabandt <cb@256bit.org>
parents:
12254
diff
changeset
|
840 menu PopUp |
7 | 841 |
842 | |
843 5.3 Showing What Menus Are Mapped To *showing-menus* | |
844 | |
845 To see what an existing menu is mapped to, use just one argument after the | |
846 menu commands (just like you would with the ":map" commands). If the menu | |
847 specified is a submenu, then all menus under that hierarchy will be shown. | |
848 If no argument is given after :menu at all, then ALL menu items are shown | |
236 | 849 for the appropriate mode (e.g., Command-line mode for :cmenu). |
7 | 850 |
851 Special characters in the list, just before the rhs: | |
852 * The menu was defined with "nore" to disallow remapping. | |
853 & The menu was defined with "<script>" to allow remapping script-local | |
854 mappings only. | |
855 - The menu was disabled. | |
856 | |
857 Note that hitting <Tab> while entering a menu name after a menu command may | |
858 be used to complete the name of the menu item. | |
859 | |
860 | |
861 5.4 Executing Menus *execute-menus* | |
862 | |
863 *:em* *:emenu* *E334* *E335* | |
864 :[range]em[enu] {menu} Execute {menu} from the command line. | |
865 The default is to execute the Normal mode | |
866 menu. If a range is specified, it executes | |
867 the Visual mode menu. | |
868 If used from <c-o>, it executes the | |
869 insert-mode menu Eg: > | |
870 :emenu File.Exit | |
871 | |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
872 :[range]em[enu] {mode} {menu} Like above, but execute the menu for {mode}: |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
873 'n': |:nmenu| Normal mode |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
874 'v': |:vmenu| Visual mode |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
875 's': |:smenu| Select mode |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
876 'o': |:omenu| Operator-pending mode |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
877 't': |:tlmenu| Terminal mode |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
878 'i': |:imenu| Insert mode |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
879 'c': |:cmenu| Cmdline mode |
15033 | 880 |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
881 |
7 | 882 If the console-mode vim has been compiled with WANT_MENU defined, you can |
883 use :emenu to access useful menu items you may have got used to from GUI | |
884 mode. See 'wildmenu' for an option that works well with this. See | |
885 |console-menus| for an example. | |
886 | |
887 When using a range, if the lines match with '<,'>, then the menu is executed | |
888 using the last visual selection. | |
889 | |
890 | |
891 5.5 Deleting Menus *delete-menus* | |
892 | |
893 *:unme* *:unmenu* | |
894 *:aun* *:aunmenu* | |
895 *:nunme* *:nunmenu* | |
896 *:ounme* *:ounmenu* | |
897 *:vunme* *:vunmenu* | |
788 | 898 *:xunme* *:xunmenu* |
899 *:sunme* *:sunmenu* | |
7 | 900 *:iunme* *:iunmenu* |
901 *:cunme* *:cunmenu* | |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
902 *:tlu* *:tlunmenu* |
7 | 903 To delete a menu item or a whole submenu, use the unmenu commands, which are |
904 analogous to the unmap commands. Eg: > | |
905 :unmenu! Edit.Paste | |
906 | |
907 This will remove the Paste item from the Edit menu for Insert and | |
908 Command-line modes. | |
909 | |
910 Note that hitting <Tab> while entering a menu name after an umenu command | |
911 may be used to complete the name of the menu item for the appropriate mode. | |
912 | |
913 To remove all menus use: *:unmenu-all* > | |
914 :unmenu * " remove all menus in Normal and visual mode | |
915 :unmenu! * " remove all menus in Insert and Command-line mode | |
15375
6012cc6936f7
patch 8.1.0695: internal error when using :popup
Bram Moolenaar <Bram@vim.org>
parents:
15033
diff
changeset
|
916 :aunmenu * " remove all menus in all modes, except for Terminal |
6012cc6936f7
patch 8.1.0695: internal error when using :popup
Bram Moolenaar <Bram@vim.org>
parents:
15033
diff
changeset
|
917 " mode |
6012cc6936f7
patch 8.1.0695: internal error when using :popup
Bram Moolenaar <Bram@vim.org>
parents:
15033
diff
changeset
|
918 :tlunmenu * " remove all menus in Terminal mode |
7 | 919 |
920 If you want to get rid of the menu bar: > | |
921 :set guioptions-=m | |
922 | |
923 | |
924 5.6 Disabling Menus *disable-menus* | |
925 | |
926 *:menu-disable* *:menu-enable* | |
927 If you do not want to remove a menu, but disable it for a moment, this can be | |
928 done by adding the "enable" or "disable" keyword to a ":menu" command. | |
929 Examples: > | |
930 :menu disable &File.&Open\.\.\. | |
931 :amenu enable * | |
932 :amenu disable &Tools.* | |
933 | |
934 The command applies to the modes as used with all menu commands. Note that | |
935 characters like "&" need to be included for translated names to be found. | |
936 When the argument is "*", all menus are affected. Otherwise the given menu | |
937 name and all existing submenus below it are affected. | |
938 | |
939 | |
940 5.7 Examples for Menus *menu-examples* | |
941 | |
942 Here is an example on how to add menu items with menu's! You can add a menu | |
943 item for the keyword under the cursor. The register "z" is used. > | |
944 | |
945 :nmenu Words.Add\ Var wb"zye:menu! Words.<C-R>z <C-R>z<CR> | |
946 :nmenu Words.Remove\ Var wb"zye:unmenu! Words.<C-R>z<CR> | |
947 :vmenu Words.Add\ Var "zy:menu! Words.<C-R>z <C-R>z <CR> | |
948 :vmenu Words.Remove\ Var "zy:unmenu! Words.<C-R>z<CR> | |
949 :imenu Words.Add\ Var <Esc>wb"zye:menu! Words.<C-R>z <C-R>z<CR>a | |
950 :imenu Words.Remove\ Var <Esc>wb"zye:unmenu! Words.<C-R>z<CR>a | |
951 | |
952 (the rhs is in <> notation, you can copy/paste this text to try out the | |
953 mappings, or put these lines in your gvimrc; "<C-R>" is CTRL-R, "<CR>" is | |
954 the <CR> key. |<>|) | |
955 | |
956 | |
957 5.8 Tooltips & Menu tips | |
958 | |
959 See section |42.4| in the user manual. | |
960 | |
961 *:tmenu* *:tm* | |
962 :tm[enu] {menupath} {rhs} Define a tip for a menu or tool. {only in | |
963 X11 and Win32 GUI} | |
964 | |
965 :tm[enu] [menupath] List menu tips. {only in X11 and Win32 GUI} | |
966 | |
967 *:tunmenu* *:tu* | |
968 :tu[nmenu] {menupath} Remove a tip for a menu or tool. | |
969 {only in X11 and Win32 GUI} | |
970 | |
14952
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
971 Note: To create menus for terminal mode, use |:tlmenu| instead. |
405309f9dd13
patch 8.1.0487: no menus specifically for the terminal window
Bram Moolenaar <Bram@vim.org>
parents:
14421
diff
changeset
|
972 |
7 | 973 When a tip is defined for a menu item, it appears in the command-line area |
974 when the mouse is over that item, much like a standard Windows menu hint in | |
236 | 975 the status bar. (Except when Vim is in Command-line mode, when of course |
7 | 976 nothing is displayed.) |
977 When a tip is defined for a ToolBar item, it appears as a tooltip when the | |
978 mouse pauses over that button, in the usual fashion. Use the |hl-Tooltip| | |
979 highlight group to change its colors. | |
980 | |
981 A "tip" can be defined for each menu item. For example, when defining a menu | |
982 item like this: > | |
983 :amenu MyMenu.Hello :echo "Hello"<CR> | |
984 The tip is defined like this: > | |
985 :tmenu MyMenu.Hello Displays a greeting. | |
986 And delete it with: > | |
987 :tunmenu MyMenu.Hello | |
988 | |
236 | 989 Tooltips are currently only supported for the X11 and Win32 GUI. However, they |
7 | 990 should appear for the other gui platforms in the not too distant future. |
991 | |
992 The ":tmenu" command works just like other menu commands, it uses the same | |
993 arguments. ":tunmenu" deletes an existing menu tip, in the same way as the | |
994 other unmenu commands. | |
995 | |
996 If a menu item becomes invalid (i.e. its actions in all modes are deleted) Vim | |
997 deletes the menu tip (and the item) for you. This means that :aunmenu deletes | |
998 a menu item - you don't need to do a :tunmenu as well. | |
999 | |
1000 | |
1001 5.9 Popup Menus | |
1002 | |
1003 In the Win32 and GTK+ GUI, you can cause a menu to popup at the cursor. | |
1004 This behaves similarly to the PopUp menus except that any menu tree can | |
1005 be popped up. | |
1006 | |
1007 This command is for backwards compatibility, using it is discouraged, because | |
1008 it behaves in a strange way. | |
1009 | |
1010 *:popup* *:popu* | |
1011 :popu[p] {name} Popup the menu {name}. The menu named must | |
1012 have at least one subentry, but need not | |
1013 appear on the menu-bar (see |hidden-menus|). | |
13437 | 1014 {only available for Win32 and GTK GUI or in |
17909 | 1015 the terminal} |
7 | 1016 |
398 | 1017 :popu[p]! {name} Like above, but use the position of the mouse |
1018 pointer instead of the cursor. | |
13437 | 1019 In the terminal this is the last known |
1020 position, which is usually at the last click | |
14006 | 1021 or release (mouse movement is irrelevant). |
398 | 1022 |
7 | 1023 Example: > |
1024 :popup File | |
398 | 1025 will make the "File" menu (if there is one) appear at the text cursor (mouse |
1026 pointer if ! was used). > | |
7 | 1027 |
1028 :amenu ]Toolbar.Make :make<CR> | |
1029 :popup ]Toolbar | |
1030 This creates a popup menu that doesn't exist on the main menu-bar. | |
1031 | |
13437 | 1032 Note that in the GUI the :popup command will return immediately, before a |
1033 selection has been made. In the terminal the commands waits for the user to | |
1034 make a selection. | |
1035 | |
7 | 1036 Note that a menu that starts with ']' will not be displayed. |
1037 | |
1038 ============================================================================== | |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1039 6. Font |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1040 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1041 This section describes font related options. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1042 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1043 GUIFONT *gui-font* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1044 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1045 'guifont' is the option that tells Vim what font to use. In its simplest form |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1046 the value is just one font name. It can also be a list of font names |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1047 separated with commas. The first valid font is used. When no valid font can |
16808 | 1048 be found you will get an error message. |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1049 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1050 On systems where 'guifontset' is supported (X11) and 'guifontset' is not |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1051 empty, then 'guifont' is not used. See |xfontset|. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1052 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1053 Note: As to the GTK GUIs, no error is given against any invalid names, and the |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1054 first element of the list is always picked up and made use of. This is |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1055 because, instead of identifying a given name with a font, the GTK GUIs use it |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1056 to construct a pattern and try to look up a font which best matches the |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1057 pattern among available fonts, and this way, the matching never fails. An |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1058 invalid name doesn't matter because a number of font properties other than |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1059 name will do to get the matching done. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1060 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1061 Spaces after a comma are ignored. To include a comma in a font name precede |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1062 it with a backslash. Setting an option requires an extra backslash before a |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1063 space and a backslash. See also |option-backslash|. For example: > |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1064 :set guifont=Screen15,\ 7x13,font\\,with\\,commas |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1065 will make Vim try to use the font "Screen15" first, and if it fails it will |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1066 try to use "7x13" and then "font,with,commas" instead. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1067 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1068 If none of the fonts can be loaded, Vim will keep the current setting. If an |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1069 empty font list is given, Vim will try using other resource settings (for X, |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1070 it will use the Vim.font resource), and finally it will try some builtin |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1071 default which should always be there ("7x13" in the case of X). The font |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1072 names given should be "normal" fonts. Vim will try to find the related bold |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1073 and italic fonts. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1074 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1075 For Win32, GTK, Motif, Mac OS and Photon: > |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1076 :set guifont=* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1077 will bring up a font requester, where you can pick the font you want. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1078 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1079 The font name depends on the GUI used. See |setting-guifont| for a way to set |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1080 'guifont' for various systems. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1081 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1082 For the GTK+ 2 and 3 GUIs, the font name looks like this: > |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1083 :set guifont=Andale\ Mono\ 11 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1084 That's all. XLFDs are not used. For Chinese this is reported to work well: > |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1085 if has("gui_gtk2") |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1086 set guifont=Bitstream\ Vera\ Sans\ Mono\ 12,Fixed\ 12 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1087 set guifontwide=Microsoft\ Yahei\ 12,WenQuanYi\ Zen\ Hei\ 12 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1088 endif |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1089 < |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1090 (Replace gui_gtk2 with gui_gtk3 for the GTK+ 3 GUI) |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1091 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1092 For Mac OSX you can use something like this: > |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1093 :set guifont=Monaco:h10 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1094 Also see 'macatsui', it can help fix display problems. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1095 *E236* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1096 Note that the fonts must be mono-spaced (all characters have the same width). |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1097 An exception is GTK: all fonts are accepted, but mono-spaced fonts look best. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1098 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1099 To preview a font on X11, you might be able to use the "xfontsel" program. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1100 The "xlsfonts" program gives a list of all available fonts. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1101 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1102 For the Win32 GUI *E244* *E245* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1103 - Takes these options in the font name (use a ':' to separate the options): |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1104 hXX - height is XX (points, can be floating-point) |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1105 wXX - width is XX (points, can be floating-point) |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1106 WXX - weight is XX (see Note on Weights below) |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1107 b - bold. This is equivalent to setting the weight to 700. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1108 i - italic |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1109 u - underline |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1110 s - strikeout |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1111 cXX - character set XX. Valid charsets are: ANSI, ARABIC, BALTIC, |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1112 CHINESEBIG5, DEFAULT, EASTEUROPE, GB2312, GREEK, HANGEUL, |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1113 HEBREW, JOHAB, MAC, OEM, RUSSIAN, SHIFTJIS, SYMBOL, THAI, |
16808 | 1114 TURKISH and VIETNAMESE. Normally you would use "cDEFAULT". |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1115 qXX - quality XX. Valid quality names are: PROOF, DRAFT, ANTIALIASED, |
16808 | 1116 NONANTIALIASED, CLEARTYPE and DEFAULT. Normally you would use |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1117 "qDEFAULT". |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1118 Some quality values are not supported in legacy OSs. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1119 - A '_' can be used in the place of a space, so you don't need to use |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1120 backslashes to escape the spaces. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1121 Examples: > |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1122 :set guifont=courier_new:h12:w5:b:cRUSSIAN |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1123 :set guifont=Andale_Mono:h7.5:w4.5 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1124 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1125 See also |font-sizes|. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1126 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1127 Note on Weights: Fonts often come with a variety of weights. "Normal" weights |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1128 in Windows have a value of 400 and, left unspecified, this is the value that |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1129 will be used when attempting to find fonts. Windows will often match fonts |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1130 based on their weight with higher priority than the font name which means a |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1131 Book or Medium variant of a font might be used despite specifying a Light or |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1132 ExtraLight variant. If you are experiencing heavier weight substitution, then |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1133 explicitly setting a lower weight value may mitigate against this unwanted |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1134 substitution. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1135 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1136 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1137 GUIFONTWIDE *gui-fontwide* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1138 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1139 When not empty, 'guifontwide' specifies a comma-separated list of fonts to be |
16808 | 1140 used for double-width characters. The first font that can be loaded is used. |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1141 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1142 Note: The size of these fonts must be exactly twice as wide as the one |
16808 | 1143 specified with 'guifont' and the same height. If there is a mismatch then the |
1144 text will not be drawn correctly. | |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1145 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1146 All GUI versions but GTK+: |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1147 |
16808 | 1148 'guifontwide' is only used when 'encoding' is set to "utf-8" and 'guifontset' |
1149 is empty or invalid. | |
1150 When 'guifont' is set and a valid font is found in it and 'guifontwide' is | |
1151 empty Vim will attempt to find a matching double-width font and set | |
1152 'guifontwide' to it. | |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1153 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1154 GTK+ GUI only: *guifontwide_gtk* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1155 |
16808 | 1156 If set and valid, 'guifontwide' is always used for double width characters, |
1157 even if 'encoding' is not set to "utf-8". | |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1158 Vim does not attempt to find an appropriate value for 'guifontwide' |
16808 | 1159 automatically. If 'guifontwide' is empty Pango/Xft will choose the font for |
1160 characters not available in 'guifont'. Thus you do not need to set | |
1161 'guifontwide' at all unless you want to override the choice made by Pango/Xft. | |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1162 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1163 Windows +multibyte only: *guifontwide_win_mbyte* |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1164 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1165 If set and valid, 'guifontwide' is used for IME instead of 'guifont'. |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1166 |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1167 ============================================================================== |
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1168 7. Extras *gui-extras* |
7 | 1169 |
1170 This section describes other features which are related to the GUI. | |
1171 | |
1172 - With the GUI, there is no wait for one second after hitting escape, because | |
1173 the key codes don't start with <Esc>. | |
1174 | |
1175 - Typing ^V followed by a special key in the GUI will insert "<Key>", since | |
1176 the internal string used is meaningless. Modifiers may also be held down to | |
1177 get "<Modifiers-Key>". | |
1178 | |
1179 - In the GUI, the modifiers SHIFT, CTRL, and ALT (or META) may be used within | |
16808 | 1180 mappings of special keys and mouse events. |
1181 E.g.: :map <M-LeftDrag> <LeftDrag> | |
7 | 1182 |
1183 - In the GUI, several normal keys may have modifiers in mappings etc, these | |
1184 are <Space>, <Tab>, <NL>, <CR>, <Esc>. | |
1185 | |
1186 - To check in a Vim script if the GUI is being used, you can use something | |
1187 like this: > | |
1188 | |
1189 if has("gui_running") | |
1190 echo "yes, we have a GUI" | |
1191 else | |
1192 echo "Boring old console" | |
1193 endif | |
8 | 1194 < *setting-guifont* |
1195 - When you use the same vimrc file on various systems, you can use something | |
1196 like this to set options specifically for each type of GUI: > | |
1197 | |
1198 if has("gui_running") | |
1199 if has("gui_gtk2") | |
1200 :set guifont=Luxi\ Mono\ 12 | |
1201 elseif has("x11") | |
1202 " Also for GTK 1 | |
1203 :set guifont=*-lucidatypewriter-medium-r-normal-*-*-180-*-*-m-*-* | |
1204 elseif has("gui_win32") | |
1205 :set guifont=Luxi_Mono:h12:cANSI | |
1206 endif | |
1207 endif | |
7 | 1208 |
678 | 1209 A recommended Japanese font is MS Mincho. You can find info here: |
1210 http://www.lexikan.com/mincho.htm | |
1211 | |
7 | 1212 ============================================================================== |
16439
9d20e26dc13c
patch 8.1.1224: MS-Windows: cannot specify font weight
Bram Moolenaar <Bram@vim.org>
parents:
15375
diff
changeset
|
1213 8. Shell Commands *gui-shell* |
7 | 1214 |
1215 For the X11 GUI the external commands are executed inside the gvim window. | |
1216 See |gui-pty|. | |
1217 | |
16808 | 1218 WARNING: Executing an external command from the X11 GUI will not always work. |
1219 "normal" commands like "ls", "grep" and "make" mostly work fine. | |
7 | 1220 Commands that require an intelligent terminal like "less" and "ispell" won't |
1221 work. Some may even hang and need to be killed from another terminal. So be | |
1222 careful! | |
1223 | |
1224 For the Win32 GUI the external commands are executed in a separate window. | |
1225 See |gui-shell-win32|. | |
1226 | |
14421 | 1227 vim:tw=78:sw=4:ts=8:noet:ft=help:norl: |