Mercurial > vim
annotate runtime/doc/gui.txt @ 9068:0a3bc9fdea20 v7.4.1819
commit https://github.com/vim/vim/commit/827b165b2aebad2cfe98cc6d5804c6c0fe8afd89
Author: Bram Moolenaar <Bram@vim.org>
Date: Thu May 5 18:14:03 2016 +0200
patch 7.4.1819
Problem: Compiler warnings when sprintf() is a macro.
Solution: Don't interrupt sprintf() with an #ifdef. (Michael Jarvis,
closes https://github.com/vim/vim/issues/788)
| author | Christian Brabandt <cb@256bit.org> |
|---|---|
| date | Thu, 05 May 2016 18:15:05 +0200 |
| parents | 3456e2ebebd4 |
| children | 9f48eab77d62 |
| rev | line source |
|---|---|
| 5697 | 1 *gui.txt* For Vim version 7.4. Last change: 2014 Mar 08 |
| 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| | |
| 14 6. Extras |gui-extras| | |
| 15 7. Shell Commands |gui-shell| | |
| 16 | |
| 17 Other GUI documentation: | |
| 18 |gui_x11.txt| For specific items of the X11 GUI. | |
| 19 |gui_w32.txt| For specific items of the Win32 GUI. | |
| 20 | |
| 21 {Vi does not have any of these commands} | |
| 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". | |
| 70 - For Win32, when $HOME is not set, "$VIM\_gvimrc" is used. | |
| 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 | |
| 82 "-u NONE" and no "-U" argument was given, or when started with "-U NONE". | |
| 83 | |
| 84 All this happens AFTER the normal Vim initializations, like reading your | |
| 85 .vimrc file. See |initialization|. | |
| 86 But the GUI window is only opened after all the initializations have been | |
| 87 carried out. If you want some commands to be executed just after opening the | |
| 88 GUI window, use the |GUIEnter| autocommand event. Example: > | |
| 465 | 89 :autocmd GUIEnter * winpos 100 50 |
| 7 | 90 |
| 91 You can use the gvimrc files to set up your own customized menus (see |:menu|) | |
| 92 and initialize other things that you may want to set up differently from the | |
| 93 terminal version. | |
| 94 | |
| 95 Recommended place for your personal GUI initializations: | |
|
4863
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
96 Unix $HOME/.gvimrc or $HOME/.vim/gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
97 OS/2 $HOME/.gvimrc, $HOME/vimfiles/gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
98 or $VIM/.gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
99 MS-DOS and Win32 $HOME/_gvimrc, $HOME/vimfiles/gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
100 or $VIM/_gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
101 Amiga s:.gvimrc, home:.gvimrc, home:vimfiles:gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
102 or $VIM/.gvimrc |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
103 |
|
c4d4f0fc12b9
updated for version 7.3.1178
Bram Moolenaar <bram@vim.org>
parents:
3082
diff
changeset
|
104 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
|
105 and only the first one that is found is read. |
| 7 | 106 |
| 107 There are a number of options which only have meaning in the GUI version of | |
| 108 Vim. These are 'guicursor', 'guifont', 'guipty' and 'guioptions'. They are | |
| 109 documented in |options.txt| with all the other options. | |
| 110 | |
| 862 | 111 If using the Motif or Athena version of the GUI (but not for the GTK+ or |
| 11 | 112 Win32 version), a number of X resources are available. See |gui-resources|. |
| 7 | 113 |
| 114 Another way to set the colors for different occasions is with highlight | |
| 115 groups. The "Normal" group is used to set the background and foreground | |
| 116 colors. Example (which looks nice): > | |
| 117 | |
| 118 :highlight Normal guibg=grey90 | |
| 119 | |
| 120 The "guibg" and "guifg" settings override the normal background and | |
| 121 foreground settings. The other settings for the Normal highlight group are | |
| 122 not used. Use the 'guifont' option to set the font. | |
| 123 | |
| 124 Also check out the 'guicursor' option, to set the colors for the cursor in | |
| 125 various modes. | |
| 126 | |
| 127 Vim tries to make the window fit on the screen when it starts up. This avoids | |
| 128 that you can't see part of it. On the X Window System this requires a bit of | |
| 129 guesswork. You can change the height that is used for the window title and a | |
| 130 task bar with the 'guiheadroom' option. | |
| 131 | |
| 132 *:winp* *:winpos* *E188* | |
| 133 :winp[os] | |
| 134 Display current position of the top left corner of the GUI vim | |
| 135 window in pixels. Does not work in all versions. | |
| 5697 | 136 Also see |getwinposx()| and |getwinposy()|. |
| 7 | 137 |
| 138 :winp[os] {X} {Y} *E466* | |
| 139 Put the GUI vim window at the given {X} and {Y} coordinates. | |
| 140 The coordinates should specify the position in pixels of the | |
| 141 top left corner of the window. Does not work in all versions. | |
| 142 Does work in an (new) xterm |xterm-color|. | |
| 143 When the GUI window has not been opened yet, the values are | |
| 144 remembered until the window is opened. The position is | |
| 145 adjusted to make the window fit on the screen (if possible). | |
| 146 | |
| 147 *:win* *:winsize* *E465* | |
| 148 :win[size] {width} {height} | |
| 149 Set the window height to {width} by {height} characters. | |
| 150 Obsolete, use ":set lines=11 columns=22". | |
| 151 If you get less lines than expected, check the 'guiheadroom' | |
| 152 option. | |
| 153 | |
| 154 If you are running the X Window System, you can get information about the | |
| 5697 | 155 window Vim is running in with these commands: > |
| 7 | 156 :!xwininfo -id $WINDOWID |
| 5697 | 157 :!xprop -id $WINDOWID |
| 158 :execute '!xwininfo -id ' . v:windowid | |
| 159 :execute '!xprop -id ' . v:windowid | |
| 3082 | 160 < |
| 161 *gui-IME* *iBus* | |
| 162 Input methods for international characters in X that rely on the XIM | |
| 163 framework, most notably iBus, have been known to produce undesirable results | |
| 164 in gVim. These may include an inability to enter spaces, or long delays | |
| 165 between typing a character and it being recognized by the application. | |
| 166 | |
| 167 One workaround that has been successful, for unknown reasons, is to prevent | |
| 168 gvim from forking into the background by starting it with the |-f| argument. | |
| 7 | 169 |
| 170 ============================================================================== | |
| 171 2. Scrollbars *gui-scrollbars* | |
| 172 | |
| 98 | 173 There are vertical scrollbars and a horizontal scrollbar. You may |
| 7 | 174 configure which ones appear with the 'guioptions' option. |
| 175 | |
| 176 The interface looks like this (with ":set guioptions=mlrb"): | |
| 177 | |
| 2642 | 178 +------------------------------+ ` |
| 179 | File Edit Help | <- Menu bar (m) ` | |
| 180 +-+--------------------------+-+ ` | |
| 181 |^| |^| ` | |
| 182 |#| Text area. |#| ` | |
| 183 | | | | ` | |
| 184 |v|__________________________|v| ` | |
| 185 Normal status line -> |-+ File.c 5,2 +-| ` | |
| 186 between Vim windows |^|""""""""""""""""""""""""""|^| ` | |
| 187 | | | | ` | |
| 188 | | Another file buffer. | | ` | |
| 189 | | | | ` | |
| 190 |#| |#| ` | |
| 191 Left scrollbar (l) -> |#| |#| <- Right ` | |
| 192 |#| |#| scrollbar (r) ` | |
| 193 | | | | ` | |
| 194 |v| |v| ` | |
| 195 +-+--------------------------+-+ ` | |
| 196 | |< #### >| | <- Bottom ` | |
| 197 +-+--------------------------+-+ scrollbar (b) ` | |
| 7 | 198 |
| 199 Any of the scrollbar or menu components may be turned off by not putting the | |
| 200 appropriate letter in the 'guioptions' string. The bottom scrollbar is | |
| 201 only useful when 'nowrap' is set. | |
| 202 | |
| 203 | |
| 204 VERTICAL SCROLLBARS *gui-vert-scroll* | |
| 205 | |
| 206 Each Vim window has a scrollbar next to it which may be scrolled up and down | |
| 207 to move through the text in that buffer. The size of the scrollbar-thumb | |
| 208 indicates the fraction of the buffer which can be seen in the window. | |
| 209 When the scrollbar is dragged all the way down, the last line of the file | |
| 210 will appear in the top of the window. | |
| 211 | |
| 212 If a window is shrunk to zero height (by the growth of another window) its | |
| 236 | 213 scrollbar disappears. It reappears when the window is restored. |
| 7 | 214 |
| 215 If a window is vertically split, it will get a scrollbar when it is the | |
| 216 current window and when, taking the middle of the current window and drawing a | |
| 217 vertical line, this line goes through the window. | |
| 218 When there are scrollbars on both sides, and the middle of the current window | |
| 219 is on the left half, the right scrollbar column will contain scrollbars for | |
| 220 the rightmost windows. The same happens on the other side. | |
| 221 | |
| 222 | |
| 223 HORIZONTAL SCROLLBARS *gui-horiz-scroll* | |
| 224 | |
| 225 The horizontal scrollbar (at the bottom of the Vim GUI) may be used to | |
| 226 scroll text sideways when the 'wrap' option is turned off. The | |
| 227 scrollbar-thumb size is such that the text of the longest visible line may be | |
| 228 scrolled as far as possible left and right. The cursor is moved when | |
| 229 necessary, it must remain on a visible character (unless 'virtualedit' is | |
| 230 set). | |
| 231 | |
| 98 | 232 Computing the length of the longest visible line takes quite a bit of |
| 233 computation, and it has to be done every time something changes. If this | |
| 234 takes too much time or you don't like the cursor jumping to another line, | |
| 235 include the 'h' flag in 'guioptions'. Then the scrolling is limited by the | |
| 236 text of the current cursor line. | |
| 7 | 237 |
| 238 *athena-intellimouse* | |
| 239 If you have an Intellimouse and an X server that supports using the wheel, | |
| 240 then you can use the wheel to scroll the text up and down in gvim. This works | |
| 241 with XFree86 4.0 and later, and with some older versions when you add patches. | |
| 242 See |scroll-mouse-wheel|. | |
| 243 | |
| 244 For older versions of XFree86 you must patch your X server. The following | |
| 245 page has a bit of information about using the Intellimouse on Linux as well as | |
| 246 links to the patches and X server binaries (may not have the one you need | |
| 247 though): | |
| 248 http://www.inria.fr/koala/colas/mouse-wheel-scroll/ | |
| 249 | |
| 250 ============================================================================== | |
| 251 3. Mouse Control *gui-mouse* | |
| 252 | |
| 253 The mouse only works if the appropriate flag in the 'mouse' option is set. | |
| 254 When the GUI is switched on, and 'mouse' wasn't set yet, the 'mouse' option is | |
| 255 automatically set to "a", enabling it for all modes except for the | |
| 256 |hit-enter| prompt. If you don't want this, a good place to change the | |
| 257 'mouse' option is the "gvimrc" file. | |
| 258 | |
| 259 Other options that are relevant: | |
| 260 'mousefocus' window focus follows mouse pointer |gui-mouse-focus| | |
| 261 'mousemodel' what mouse button does which action | |
| 262 'mousehide' hide mouse pointer while typing text | |
| 263 'selectmode' whether to start Select mode or Visual mode | |
| 264 | |
| 265 A quick way to set these is with the ":behave" command. | |
| 266 *:behave* *:be* | |
| 267 :be[have] {model} Set behavior for mouse and selection. Valid | |
| 268 arguments are: | |
| 269 mswin MS-Windows behavior | |
| 270 xterm Xterm behavior | |
| 271 | |
| 272 Using ":behave" changes these options: | |
| 273 option mswin xterm ~ | |
| 274 'selectmode' "mouse,key" "" | |
| 275 'mousemodel' "popup" "extend" | |
| 276 'keymodel' "startsel,stopsel" "" | |
| 277 'selection' "exclusive" "inclusive" | |
| 278 | |
| 279 In the $VIMRUNTIME directory, there is a script called |mswin.vim|, which will | |
| 280 also map a few keys to the MS-Windows cut/copy/paste commands. This is NOT | |
| 281 compatible, since it uses the CTRL-V, CTRL-X and CTRL-C keys. If you don't | |
| 282 mind, use this command: > | |
| 283 :so $VIMRUNTIME/mswin.vim | |
| 284 | |
| 285 For scrolling with a wheel on a mouse, see |scroll-mouse-wheel|. | |
| 286 | |
| 287 | |
| 288 3.1 Moving Cursor with Mouse *gui-mouse-move* | |
| 289 | |
| 290 Click the left mouse button somewhere in a text buffer where you want the | |
| 291 cursor to go, and it does! | |
| 292 This works in when 'mouse' contains ~ | |
| 293 Normal mode 'n' or 'a' | |
| 294 Visual mode 'v' or 'a' | |
| 295 Insert mode 'i' or 'a' | |
| 296 | |
| 297 Select mode is handled like Visual mode. | |
| 298 | |
| 299 You may use this with an operator such as 'd' to delete text from the current | |
| 300 cursor position to the position you point to with the mouse. That is, you hit | |
| 301 'd' and then click the mouse somewhere. | |
| 302 | |
| 303 *gui-mouse-focus* | |
| 304 The 'mousefocus' option can be set to make the keyboard focus follow the | |
| 305 mouse pointer. This means that the window where the mouse pointer is, is the | |
| 306 active window. Warning: this doesn't work very well when using a menu, | |
| 307 because the menu command will always be applied to the top window. | |
| 308 | |
| 309 If you are on the ':' line (or '/' or '?'), then clicking the left or right | |
| 310 mouse button will position the cursor on the ':' line (if 'mouse' contains | |
| 311 'c', 'a' or 'A'). | |
| 312 | |
| 313 In any situation the middle mouse button may be clicked to paste the current | |
| 314 selection. | |
| 315 | |
| 316 | |
| 317 3.2 Selection with Mouse *gui-mouse-select* | |
| 318 | |
| 319 The mouse can be used to start a selection. How depends on the 'mousemodel' | |
| 320 option: | |
| 321 'mousemodel' is "extend": use the right mouse button | |
| 322 'mousemodel' is "popup": use the left mouse button, while keeping the Shift | |
| 323 key pressed. | |
| 324 | |
| 325 If there was no selection yet, this starts a selection from the old cursor | |
| 326 position to the position pointed to with the mouse. If there already is a | |
| 327 selection then the closest end will be extended. | |
| 328 | |
| 329 If 'selectmode' contains "mouse", then the selection will be in Select mode. | |
| 330 This means that typing normal text will replace the selection. See | |
| 331 |Select-mode|. Otherwise, the selection will be in Visual mode. | |
| 332 | |
| 333 Double clicking may be done to make the selection word-wise, triple clicking | |
| 334 makes it line-wise, and quadruple clicking makes it rectangular block-wise. | |
| 335 | |
| 336 See |gui-selections| on how the selection is used. | |
| 337 | |
| 338 | |
| 339 3.3 Other Text Selection with Mouse *gui-mouse-modeless* | |
| 340 *modeless-selection* | |
| 341 A different kind of selection is used when: | |
| 342 - in Command-line mode | |
| 343 - in the Command-line window and pointing in another window | |
| 344 - at the |hit-enter| prompt | |
| 345 - whenever the current mode is not in the 'mouse' option | |
| 346 - when holding the CTRL and SHIFT keys in the GUI | |
| 1619 | 347 |
| 7 | 348 Since Vim continues like the selection isn't there, and there is no mode |
| 349 associated with the selection, this is called modeless selection. Any text in | |
| 350 the Vim window can be selected. Select the text by pressing the left mouse | |
| 351 button at the start, drag to the end and release. To extend the selection, | |
| 352 use the right mouse button when 'mousemodel' is "extend", or the left mouse | |
| 353 button with the shift key pressed when 'mousemodel' is "popup". | |
| 354 The selection is removed when the selected text is scrolled or changed. | |
| 1619 | 355 |
| 7 | 356 On the command line CTRL-Y can be used to copy the selection into the |
| 1619 | 357 clipboard. To do this from Insert mode, use CTRL-O : CTRL-Y <CR>. When |
| 358 'guioptions' contains a or A (default on X11), the selection is automatically | |
| 359 copied to the "* register. | |
| 360 | |
| 361 The middle mouse button can then paste the text. On non-X11 systems, you can | |
| 362 use CTRL-R +. | |
| 7 | 363 |
| 364 | |
| 365 3.4 Using Mouse on Status Lines *gui-mouse-status* | |
| 366 | |
| 367 Clicking the left or right mouse button on the status line below a Vim | |
| 368 window makes that window the current window. This actually happens on button | |
| 369 release (to be able to distinguish a click from a drag action). | |
| 370 | |
| 371 With the left mouse button a status line can be dragged up and down, thus | |
| 372 resizing the windows above and below it. This does not change window focus. | |
| 373 | |
| 374 The same can be used on the vertical separator: click to give the window left | |
| 375 of it focus, drag left and right to make windows wider and narrower. | |
| 376 | |
| 377 | |
| 378 3.5 Various Mouse Clicks *gui-mouse-various* | |
| 379 | |
| 380 <S-LeftMouse> Search forward for the word under the mouse click. | |
| 381 When 'mousemodel' is "popup" this starts or extends a | |
| 382 selection. | |
| 383 <S-RightMouse> Search backward for the word under the mouse click. | |
| 384 <C-LeftMouse> Jump to the tag name under the mouse click. | |
| 385 <C-RightMouse> Jump back to position before the previous tag jump | |
| 386 (same as "CTRL-T") | |
| 387 | |
| 388 | |
| 389 3.6 Mouse Mappings *gui-mouse-mapping* | |
| 390 | |
| 391 The mouse events, complete with modifiers, may be mapped. Eg: > | |
| 392 :map <S-LeftMouse> <RightMouse> | |
| 393 :map <S-LeftDrag> <RightDrag> | |
| 394 :map <S-LeftRelease> <RightRelease> | |
| 395 :map <2-S-LeftMouse> <2-RightMouse> | |
| 396 :map <2-S-LeftDrag> <2-RightDrag> | |
| 397 :map <2-S-LeftRelease> <2-RightRelease> | |
| 398 :map <3-S-LeftMouse> <3-RightMouse> | |
| 399 :map <3-S-LeftDrag> <3-RightDrag> | |
| 400 :map <3-S-LeftRelease> <3-RightRelease> | |
| 401 :map <4-S-LeftMouse> <4-RightMouse> | |
| 402 :map <4-S-LeftDrag> <4-RightDrag> | |
| 403 :map <4-S-LeftRelease> <4-RightRelease> | |
| 404 These mappings make selection work the way it probably should in a Motif | |
| 405 application, with shift-left mouse allowing for extending the visual area | |
| 406 rather than the right mouse button. | |
| 407 | |
| 408 Mouse mapping with modifiers does not work for modeless selection. | |
| 409 | |
| 410 | |
| 411 3.7 Drag and drop *drag-n-drop* | |
| 412 | |
| 413 You can drag and drop one or more files into the Vim window, where they will | |
| 414 be opened as if a |:drop| command was used. | |
| 415 | |
| 416 If you hold down Shift while doing this, Vim changes to the first dropped | |
| 417 file's directory. If you hold Ctrl Vim will always split a new window for the | |
| 418 file. Otherwise it's only done if the current buffer has been changed. | |
| 419 | |
| 420 You can also drop a directory on Vim. This starts the explorer plugin for | |
| 421 that directory (assuming it was enabled, otherwise you'll get an error | |
| 422 message). Keep Shift pressed to change to the directory instead. | |
| 423 | |
| 424 If Vim happens to be editing a command line, the names of the dropped files | |
| 425 and directories will be inserted at the cursor. This allows you to use these | |
| 426 names with any Ex command. Special characters (space, tab, double quote and | |
| 427 '|'; backslash on non-MS-Windows systems) will be escaped. | |
| 428 | |
| 429 ============================================================================== | |
| 430 4. Making GUI Selections *gui-selections* | |
| 431 | |
| 432 *quotestar* | |
| 433 You may make selections with the mouse (see |gui-mouse-select|), or by using | |
| 434 Vim's Visual mode (see |v|). If 'a' is present in 'guioptions', then | |
| 435 whenever a selection is started (Visual or Select mode), or when the selection | |
| 436 is changed, Vim becomes the owner of the windowing system's primary selection | |
| 437 (on MS-Windows the |gui-clipboard| is used; under X11, the |x11-selection| is | |
| 438 used - you should read whichever of these is appropriate now). | |
| 439 | |
| 440 *clipboard* | |
| 441 There is a special register for storing this selection, it is the "* | |
| 442 register. Nothing is put in here unless the information about what text is | |
| 236 | 443 selected is about to change (e.g. with a left mouse click somewhere), or when |
| 7 | 444 another application wants to paste the selected text. Then the text is put |
| 445 in the "* register. For example, to cut a line and make it the current | |
| 446 selection/put it on the clipboard: > | |
| 447 | |
| 448 "*dd | |
| 449 | |
| 450 Similarly, when you want to paste a selection from another application, e.g., | |
| 451 by clicking the middle mouse button, the selection is put in the "* register | |
| 452 first, and then 'put' like any other register. For example, to put the | |
| 453 selection (contents of the clipboard): > | |
| 454 | |
| 455 "*p | |
| 456 | |
| 457 When using this register under X11, also see |x11-selection|. This also | |
| 458 explains the related "+ register. | |
| 459 | |
| 460 Note that when pasting text from one Vim into another separate Vim, the type | |
| 461 of selection (character, line, or block) will also be copied. For other | |
| 462 applications the type is always character. However, if the text gets | |
| 463 transferred via the |x11-cut-buffer|, the selection type is ALWAYS lost. | |
| 464 | |
| 465 When the "unnamed" string is included in the 'clipboard' option, the unnamed | |
| 466 register is the same as the "* register. Thus you can yank to and paste the | |
| 467 selection without prepending "* to commands. | |
| 468 | |
| 469 ============================================================================== | |
| 470 5. Menus *menus* | |
| 471 | |
| 472 For an introduction see |usr_42.txt| in the user manual. | |
| 473 | |
| 474 | |
| 475 5.1 Using Menus *using-menus* | |
| 476 | |
| 477 Basically, menus can be used just like mappings. You can define your own | |
| 478 menus, as many as you like. | |
| 479 Long-time Vim users won't use menus much. But the power is in adding your own | |
| 480 menus and menu items. They are most useful for things that you can't remember | |
| 481 what the key sequence was. | |
| 482 | |
| 483 For creating menus in a different language, see |:menutrans|. | |
| 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 |
| 7 | 500 < |
| 501 *console-menus* | |
| 502 Although this documentation is in the GUI section, you can actually use menus | |
| 503 in console mode too. You will have to load |menu.vim| explicitly then, it is | |
| 504 not done by default. You can use the |:emenu| command and command-line | |
| 505 completion with 'wildmenu' to access the menu entries almost like a real menu | |
| 506 system. To do this, put these commands in your .vimrc file: > | |
| 507 :source $VIMRUNTIME/menu.vim | |
| 508 :set wildmenu | |
| 509 :set cpo-=< | |
| 510 :set wcm=<C-Z> | |
| 511 :map <F4> :emenu <C-Z> | |
| 512 Pressing <F4> will start the menu. You can now use the cursor keys to select | |
| 513 a menu entry. Hit <Enter> to execute it. Hit <Esc> if you want to cancel. | |
| 514 This does require the |+menu| feature enabled at compile time. | |
| 515 | |
| 516 *tear-off-menus* | |
|
8218
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
517 GTK+ 2 and Motif support Tear-off menus. These are sort of sticky menus or |
| 7 | 518 pop-up menus that are present all the time. If the resizing does not work |
| 519 correctly, this may be caused by using something like "Vim*geometry" in the | |
| 520 defaults. Use "Vim.geometry" instead. | |
| 521 | |
|
8218
3456e2ebebd4
commit https://github.com/vim/vim/commit/9892189d2e7ab94b750f99e6da4cbfc3c8014517
Christian Brabandt <cb@256bit.org>
parents:
5697
diff
changeset
|
522 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
|
523 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
|
524 |
| 7 | 525 The Win32 GUI version emulates Motif's tear-off menus. Actually, a Motif user |
| 526 will spot the differences easily, but hopefully they're just as useful. You | |
| 527 can also use the |:tearoff| command together with |hidden-menus| to create | |
| 528 floating menus that do not appear on the main menu bar. | |
| 529 | |
| 530 | |
| 531 5.2 Creating New Menus *creating-menus* | |
| 532 | |
| 533 *:me* *:menu* *:noreme* *:noremenu* | |
| 534 *:am* *:amenu* *:an* *:anoremenu* | |
| 535 *:nme* *:nmenu* *:nnoreme* *:nnoremenu* | |
| 536 *:ome* *:omenu* *:onoreme* *:onoremenu* | |
| 537 *:vme* *:vmenu* *:vnoreme* *:vnoremenu* | |
| 788 | 538 *:xme* *:xmenu* *:xnoreme* *:xnoremenu* |
| 539 *:sme* *:smenu* *:snoreme* *:snoremenu* | |
| 7 | 540 *:ime* *:imenu* *:inoreme* *:inoremenu* |
| 541 *:cme* *:cmenu* *:cnoreme* *:cnoremenu* | |
| 542 *E330* *E327* *E331* *E336* *E333* | |
| 1120 | 543 *E328* *E329* *E337* *E792* |
| 7 | 544 To create a new menu item, use the ":menu" commands. They are mostly like |
| 545 the ":map" set of commands but the first argument is a menu item name, given | |
| 236 | 546 as a path of menus and submenus with a '.' between them, e.g.: > |
| 7 | 547 |
| 548 :menu File.Save :w<CR> | |
| 549 :inoremenu File.Save <C-O>:w<CR> | |
| 550 :menu Edit.Big\ Changes.Delete\ All\ Spaces :%s/[ ^I]//g<CR> | |
| 551 | |
| 552 This last one will create a new item in the menu bar called "Edit", holding | |
| 553 the mouse button down on this will pop up a menu containing the item | |
| 554 "Big Changes", which is a sub-menu containing the item "Delete All Spaces", | |
| 555 which when selected, performs the operation. | |
| 556 | |
| 557 Special characters in a menu name: | |
| 558 | |
| 559 & The next character is the shortcut key. Make sure each | |
| 560 shortcut key is only used once in a (sub)menu. If you want to | |
| 561 insert a literal "&" in the menu name use "&&". | |
| 562 <Tab> Separates the menu name from right-aligned text. This can be | |
| 563 used to show the equivalent typed command. The text "<Tab>" | |
| 564 can be used here for convenience. If you are using a real | |
| 1235 | 565 tab, don't forget to put a backslash before it! |
| 7 | 566 Example: > |
| 567 | |
| 568 :amenu &File.&Open<Tab>:e :browse e<CR> | |
| 569 | |
| 570 [typed literally] | |
| 571 With the shortcut "F" (while keeping the <Alt> key pressed), and then "O", | |
| 572 this menu can be used. The second part is shown as "Open :e". The ":e" | |
| 573 is right aligned, and the "O" is underlined, to indicate it is the shortcut. | |
| 574 | |
| 575 The ":amenu" command can be used to define menu entries for all modes at once. | |
| 576 To make the command work correctly, a character is automatically inserted for | |
| 577 some modes: | |
| 578 mode inserted appended ~ | |
| 579 Normal nothing nothing | |
| 580 Visual <C-C> <C-\><C-G> | |
| 2152 | 581 Insert <C-\><C-O> |
| 7 | 582 Cmdline <C-C> <C-\><C-G> |
| 583 Op-pending <C-C> <C-\><C-G> | |
| 584 | |
| 585 Appending CTRL-\ CTRL-G is for going back to insert mode when 'insertmode' is | |
| 586 set. |CTRL-\_CTRL-G| | |
| 587 | |
| 588 Example: > | |
| 589 | |
| 590 :amenu File.Next :next^M | |
| 591 | |
| 592 is equal to: > | |
| 593 | |
| 594 :nmenu File.Next :next^M | |
| 595 :vmenu File.Next ^C:next^M^\^G | |
| 2152 | 596 :imenu File.Next ^\^O:next^M |
| 7 | 597 :cmenu File.Next ^C:next^M^\^G |
| 598 :omenu File.Next ^C:next^M^\^G | |
| 599 | |
| 600 Careful: In Insert mode this only works for a SINGLE Normal mode command, | |
| 601 because of the CTRL-O. If you have two or more commands, you will need to use | |
| 602 the ":imenu" command. For inserting text in any mode, you can use the | |
| 603 expression register: > | |
| 604 | |
| 605 :amenu Insert.foobar "='foobar'<CR>P | |
| 606 | |
| 607 Note that the '<' and 'k' flags in 'cpoptions' also apply here (when | |
| 608 included they make the <> form and raw key codes not being recognized). | |
| 609 | |
| 610 Note that <Esc> in Cmdline mode executes the command, like in a mapping. This | |
| 611 is Vi compatible. Use CTRL-C to quit Cmdline mode. | |
| 612 | |
| 613 *:menu-<silent>* *:menu-silent* | |
| 614 To define a menu which will not be echoed on the command line, add | |
| 615 "<silent>" as the first argument. Example: > | |
| 616 :menu <silent> Settings.Ignore\ case :set ic<CR> | |
| 617 The ":set ic" will not be echoed when using this menu. Messages from the | |
| 618 executed command are still given though. To shut them up too, add a ":silent" | |
| 619 in the executed command: > | |
| 620 :menu <silent> Search.Header :exe ":silent normal /Header\r"<CR> | |
| 859 | 621 "<silent>" may also appear just after "<special>" or "<script>". |
| 622 | |
| 623 *:menu-<special>* *:menu-special* | |
| 624 Define a menu with <> notation for special keys, even though the "<" flag | |
| 625 may appear in 'cpoptions'. This is useful if the side effect of setting | |
| 626 'cpoptions' is not desired. Example: > | |
| 627 :menu <special> Search.Header /Header<CR> | |
| 628 "<special>" must appear as the very first argument to the ":menu" command or | |
| 629 just after "<silent>" or "<script>". | |
| 630 | |
| 7 | 631 *:menu-<script>* *:menu-script* |
| 632 The "to" part of the menu will be inspected for mappings. If you don't want | |
| 633 this, use the ":noremenu" command (or the similar one for a specific mode). | |
| 634 If you do want to use script-local mappings, add "<script>" as the very first | |
| 859 | 635 argument to the ":menu" command or just after "<silent>" or "<special>". |
| 7 | 636 |
| 637 *menu-priority* | |
| 638 You can give a priority to a menu. Menus with a higher priority go more to | |
| 639 the right. The priority is given as a number before the ":menu" command. | |
| 640 Example: > | |
| 641 :80menu Buffer.next :bn<CR> | |
| 642 | |
| 643 The default menus have these priorities: | |
| 644 File 10 | |
| 645 Edit 20 | |
| 646 Tools 40 | |
| 647 Syntax 50 | |
| 648 Buffers 60 | |
| 649 Window 70 | |
| 650 Help 9999 | |
| 651 | |
| 652 When no or zero priority is given, 500 is used. | |
| 653 The priority for the PopUp menu is not used. | |
| 654 | |
| 655 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
|
656 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
|
657 anymore because right-aligning the Help menu is now discouraged UI design. |
| 7 | 658 |
| 659 You can use a priority higher than 9999, to make it go after the Help menu, | |
| 660 but that is non-standard and is discouraged. The highest possible priority is | |
| 661 about 32000. The lowest is 1. | |
| 662 | |
| 663 *sub-menu-priority* | |
| 664 The same mechanism can be used to position a sub-menu. The priority is then | |
| 665 given as a dot-separated list of priorities, before the menu name: > | |
| 666 :menu 80.500 Buffer.next :bn<CR> | |
| 667 Giving the sub-menu priority is only needed when the item is not to be put | |
| 668 in a normal position. For example, to put a sub-menu before the other items: > | |
| 669 :menu 80.100 Buffer.first :brew<CR> | |
| 670 Or to put a sub-menu after the other items, and further items with default | |
| 671 priority will be put before it: > | |
| 672 :menu 80.900 Buffer.last :blast<CR> | |
| 673 When a number is missing, the default value 500 will be used: > | |
| 674 :menu .900 myMenu.test :echo "text"<CR> | |
| 675 The menu priority is only used when creating a new menu. When it already | |
| 676 existed, e.g., in another mode, the priority will not change. Thus, the | |
| 677 priority only needs to be given the first time a menu is used. | |
| 678 An exception is the PopUp menu. There is a separate menu for each mode | |
| 679 (Normal, Op-pending, Visual, Insert, Cmdline). The order in each of these | |
| 680 menus can be different. This is different from menu-bar menus, which have | |
| 681 the same order for all modes. | |
| 682 NOTE: sub-menu priorities currently don't work for all versions of the GUI. | |
| 683 | |
| 684 *menu-separator* *E332* | |
| 685 Menu items can be separated by a special item that inserts some space between | |
| 686 items. Depending on the system this is displayed as a line or a dotted line. | |
| 687 These items must start with a '-' and end in a '-'. The part in between is | |
| 688 used to give it a unique name. Priorities can be used as with normal items. | |
| 689 Example: > | |
| 690 :menu Example.item1 :do something | |
| 691 :menu Example.-Sep- : | |
| 692 :menu Example.item2 :do something different | |
| 693 Note that the separator also requires a rhs. It doesn't matter what it is, | |
| 694 because the item will never be selected. Use a single colon to keep it | |
| 695 simple. | |
| 696 | |
| 697 *gui-toolbar* | |
| 11 | 698 The toolbar is currently available in the Win32, Athena, Motif, GTK+ (X11), |
| 862 | 699 and Photon GUI. It should turn up in other GUIs in due course. The |
| 236 | 700 default toolbar is setup in menu.vim. |
| 701 The display of the toolbar is controlled by the 'guioptions' letter 'T'. You | |
| 7 | 702 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
|
703 The appearance is controlled by the 'toolbar' option. You can choose between |
| 7 | 704 an image, text or both. |
| 705 | |
| 706 *toolbar-icon* | |
| 707 The toolbar is defined as a special menu called ToolBar, which only has one | |
| 708 level. Vim interprets the items in this menu as follows: | |
| 709 1) If an "icon=" argument was specified, the file with this name is used. | |
| 710 The file can either be specified with the full path or with the base name. | |
| 711 In the last case it is searched for in the "bitmaps" directory in | |
| 236 | 712 'runtimepath', like in point 3. Examples: > |
| 7 | 713 :amenu icon=/usr/local/pixmaps/foo_icon.xpm ToolBar.Foo :echo "Foo"<CR> |
| 714 :amenu icon=FooIcon ToolBar.Foo :echo "Foo"<CR> | |
| 715 < Note that in the first case the extension is included, while in the second | |
| 716 case it is omitted. | |
| 717 If the file cannot be opened the next points are tried. | |
| 718 A space in the file name must be escaped with a backslash. | |
| 719 A menu priority must come _after_ the icon argument: > | |
| 720 :amenu icon=foo 1.42 ToolBar.Foo :echo "42!"<CR> | |
| 721 2) An item called 'BuiltIn##', where ## is a number, is taken as number ## of | |
| 236 | 722 the built-in bitmaps available in Vim. Currently there are 31 numbered |
| 7 | 723 from 0 to 30 which cover most common editing operations |builtin-tools|. > |
| 724 :amenu ToolBar.BuiltIn22 :call SearchNext("back")<CR> | |
| 725 3) An item with another name is first searched for in the directory | |
| 726 "bitmaps" in 'runtimepath'. If found, the bitmap file is used as the | |
| 727 toolbar button image. Note that the exact filename is OS-specific: For | |
| 728 example, under Win32 the command > | |
| 729 :amenu ToolBar.Hello :echo "hello"<CR> | |
| 730 < would find the file 'hello.bmp'. Under GTK+/X11 it is 'Hello.xpm'. With | |
| 731 GTK+ 2 the files 'Hello.png', 'Hello.xpm' and 'Hello.bmp' are checked for | |
| 732 existence, and the first one found would be used. | |
| 733 For MS-Windows and GTK+ 2 the bitmap is scaled to fit the button. For | |
| 734 MS-Windows a size of 18 by 18 pixels works best. | |
| 735 For MS-Windows the bitmap should have 16 colors with the standard palette. | |
| 736 The light grey pixels will be changed to the Window frame color and the | |
| 737 dark grey pixels to the window shadow color. More colors might also work, | |
| 738 depending on your system. | |
| 739 4) If the bitmap is still not found, Vim checks for a match against its list | |
| 740 of built-in names. Each built-in button image has a name. | |
| 741 So the command > | |
| 742 :amenu ToolBar.Open :e | |
| 743 < will show the built-in "open a file" button image if no open.bmp exists. | |
| 744 All the built-in names can be seen used in menu.vim. | |
| 745 5) If all else fails, a blank, but functioning, button is displayed. | |
| 746 | |
| 747 *builtin-tools* | |
| 748 nr Name Normal action ~ | |
| 749 00 New open new window | |
| 750 01 Open browse for file to open in current window | |
| 751 02 Save write buffer to file | |
| 752 03 Undo undo last change | |
| 753 04 Redo redo last undone change | |
| 754 05 Cut delete selected text to clipboard | |
| 755 06 Copy copy selected text to clipboard | |
| 756 07 Paste paste text from clipboard | |
| 757 08 Print print current buffer | |
| 758 09 Help open a buffer on Vim's builtin help | |
| 759 10 Find start a search command | |
| 760 11 SaveAll write all modified buffers to file | |
| 761 12 SaveSesn write session file for current situation | |
| 762 13 NewSesn write new session file | |
| 763 14 LoadSesn load session file | |
| 764 15 RunScript browse for file to run as a Vim script | |
| 765 16 Replace prompt for substitute command | |
| 766 17 WinClose close current window | |
| 767 18 WinMax make current window use many lines | |
| 768 19 WinMin make current window use few lines | |
| 769 20 WinSplit split current window | |
| 770 21 Shell start a shell | |
| 771 22 FindPrev search again, backward | |
| 772 23 FindNext search again, forward | |
| 773 24 FindHelp prompt for word to search help for | |
| 774 25 Make run make and jump to first error | |
| 775 26 TagJump jump to tag under the cursor | |
| 776 27 RunCtags build tags for files in current directory | |
| 777 28 WinVSplit split current window vertically | |
| 778 29 WinMaxWidth make current window use many columns | |
| 779 30 WinMinWidth make current window use few columns | |
| 780 | |
| 781 *hidden-menus* *win32-hidden-menus* | |
| 782 In the Win32 and GTK+ GUI, starting a menu name with ']' excludes that menu | |
| 783 from the main menu bar. You must then use the |:popup| or |:tearoff| command | |
| 784 to display it. | |
| 785 | |
| 786 *popup-menu* | |
| 862 | 787 In the Win32, GTK+, Motif, Athena and Photon GUI, you can define the |
| 434 | 788 special menu "PopUp". This is the menu that is displayed when the right mouse |
| 789 button is pressed, if 'mousemodel' is set to popup or popup_setpos. | |
| 7 | 790 |
| 791 | |
| 792 5.3 Showing What Menus Are Mapped To *showing-menus* | |
| 793 | |
| 794 To see what an existing menu is mapped to, use just one argument after the | |
| 795 menu commands (just like you would with the ":map" commands). If the menu | |
| 796 specified is a submenu, then all menus under that hierarchy will be shown. | |
| 797 If no argument is given after :menu at all, then ALL menu items are shown | |
| 236 | 798 for the appropriate mode (e.g., Command-line mode for :cmenu). |
| 7 | 799 |
| 800 Special characters in the list, just before the rhs: | |
| 801 * The menu was defined with "nore" to disallow remapping. | |
| 802 & The menu was defined with "<script>" to allow remapping script-local | |
| 803 mappings only. | |
| 804 - The menu was disabled. | |
| 805 | |
| 806 Note that hitting <Tab> while entering a menu name after a menu command may | |
| 807 be used to complete the name of the menu item. | |
| 808 | |
| 809 | |
| 810 5.4 Executing Menus *execute-menus* | |
| 811 | |
| 812 *:em* *:emenu* *E334* *E335* | |
| 813 :[range]em[enu] {menu} Execute {menu} from the command line. | |
| 814 The default is to execute the Normal mode | |
| 815 menu. If a range is specified, it executes | |
| 816 the Visual mode menu. | |
| 817 If used from <c-o>, it executes the | |
| 818 insert-mode menu Eg: > | |
| 819 :emenu File.Exit | |
| 820 | |
| 821 If the console-mode vim has been compiled with WANT_MENU defined, you can | |
| 822 use :emenu to access useful menu items you may have got used to from GUI | |
| 823 mode. See 'wildmenu' for an option that works well with this. See | |
| 824 |console-menus| for an example. | |
| 825 | |
| 826 When using a range, if the lines match with '<,'>, then the menu is executed | |
| 827 using the last visual selection. | |
| 828 | |
| 829 | |
| 830 5.5 Deleting Menus *delete-menus* | |
| 831 | |
| 832 *:unme* *:unmenu* | |
| 833 *:aun* *:aunmenu* | |
| 834 *:nunme* *:nunmenu* | |
| 835 *:ounme* *:ounmenu* | |
| 836 *:vunme* *:vunmenu* | |
| 788 | 837 *:xunme* *:xunmenu* |
| 838 *:sunme* *:sunmenu* | |
| 7 | 839 *:iunme* *:iunmenu* |
| 840 *:cunme* *:cunmenu* | |
| 841 To delete a menu item or a whole submenu, use the unmenu commands, which are | |
| 842 analogous to the unmap commands. Eg: > | |
| 843 :unmenu! Edit.Paste | |
| 844 | |
| 845 This will remove the Paste item from the Edit menu for Insert and | |
| 846 Command-line modes. | |
| 847 | |
| 848 Note that hitting <Tab> while entering a menu name after an umenu command | |
| 849 may be used to complete the name of the menu item for the appropriate mode. | |
| 850 | |
| 851 To remove all menus use: *:unmenu-all* > | |
| 852 :unmenu * " remove all menus in Normal and visual mode | |
| 853 :unmenu! * " remove all menus in Insert and Command-line mode | |
| 854 :aunmenu * " remove all menus in all modes | |
| 855 | |
| 856 If you want to get rid of the menu bar: > | |
| 857 :set guioptions-=m | |
| 858 | |
| 859 | |
| 860 5.6 Disabling Menus *disable-menus* | |
| 861 | |
| 862 *:menu-disable* *:menu-enable* | |
| 863 If you do not want to remove a menu, but disable it for a moment, this can be | |
| 864 done by adding the "enable" or "disable" keyword to a ":menu" command. | |
| 865 Examples: > | |
| 866 :menu disable &File.&Open\.\.\. | |
| 867 :amenu enable * | |
| 868 :amenu disable &Tools.* | |
| 869 | |
| 870 The command applies to the modes as used with all menu commands. Note that | |
| 871 characters like "&" need to be included for translated names to be found. | |
| 872 When the argument is "*", all menus are affected. Otherwise the given menu | |
| 873 name and all existing submenus below it are affected. | |
| 874 | |
| 875 | |
| 876 5.7 Examples for Menus *menu-examples* | |
| 877 | |
| 878 Here is an example on how to add menu items with menu's! You can add a menu | |
| 879 item for the keyword under the cursor. The register "z" is used. > | |
| 880 | |
| 881 :nmenu Words.Add\ Var wb"zye:menu! Words.<C-R>z <C-R>z<CR> | |
| 882 :nmenu Words.Remove\ Var wb"zye:unmenu! Words.<C-R>z<CR> | |
| 883 :vmenu Words.Add\ Var "zy:menu! Words.<C-R>z <C-R>z <CR> | |
| 884 :vmenu Words.Remove\ Var "zy:unmenu! Words.<C-R>z<CR> | |
| 885 :imenu Words.Add\ Var <Esc>wb"zye:menu! Words.<C-R>z <C-R>z<CR>a | |
| 886 :imenu Words.Remove\ Var <Esc>wb"zye:unmenu! Words.<C-R>z<CR>a | |
| 887 | |
| 888 (the rhs is in <> notation, you can copy/paste this text to try out the | |
| 889 mappings, or put these lines in your gvimrc; "<C-R>" is CTRL-R, "<CR>" is | |
| 890 the <CR> key. |<>|) | |
| 891 | |
| 892 | |
| 893 5.8 Tooltips & Menu tips | |
| 894 | |
| 895 See section |42.4| in the user manual. | |
| 896 | |
| 897 *:tmenu* *:tm* | |
| 898 :tm[enu] {menupath} {rhs} Define a tip for a menu or tool. {only in | |
| 899 X11 and Win32 GUI} | |
| 900 | |
| 901 :tm[enu] [menupath] List menu tips. {only in X11 and Win32 GUI} | |
| 902 | |
| 903 *:tunmenu* *:tu* | |
| 904 :tu[nmenu] {menupath} Remove a tip for a menu or tool. | |
| 905 {only in X11 and Win32 GUI} | |
| 906 | |
| 907 When a tip is defined for a menu item, it appears in the command-line area | |
| 908 when the mouse is over that item, much like a standard Windows menu hint in | |
| 236 | 909 the status bar. (Except when Vim is in Command-line mode, when of course |
| 7 | 910 nothing is displayed.) |
| 911 When a tip is defined for a ToolBar item, it appears as a tooltip when the | |
| 912 mouse pauses over that button, in the usual fashion. Use the |hl-Tooltip| | |
| 913 highlight group to change its colors. | |
| 914 | |
| 915 A "tip" can be defined for each menu item. For example, when defining a menu | |
| 916 item like this: > | |
| 917 :amenu MyMenu.Hello :echo "Hello"<CR> | |
| 918 The tip is defined like this: > | |
| 919 :tmenu MyMenu.Hello Displays a greeting. | |
| 920 And delete it with: > | |
| 921 :tunmenu MyMenu.Hello | |
| 922 | |
| 236 | 923 Tooltips are currently only supported for the X11 and Win32 GUI. However, they |
| 7 | 924 should appear for the other gui platforms in the not too distant future. |
| 925 | |
| 926 The ":tmenu" command works just like other menu commands, it uses the same | |
| 927 arguments. ":tunmenu" deletes an existing menu tip, in the same way as the | |
| 928 other unmenu commands. | |
| 929 | |
| 930 If a menu item becomes invalid (i.e. its actions in all modes are deleted) Vim | |
| 931 deletes the menu tip (and the item) for you. This means that :aunmenu deletes | |
| 932 a menu item - you don't need to do a :tunmenu as well. | |
| 933 | |
| 934 | |
| 935 5.9 Popup Menus | |
| 936 | |
| 937 In the Win32 and GTK+ GUI, you can cause a menu to popup at the cursor. | |
| 938 This behaves similarly to the PopUp menus except that any menu tree can | |
| 939 be popped up. | |
| 940 | |
| 941 This command is for backwards compatibility, using it is discouraged, because | |
| 942 it behaves in a strange way. | |
| 943 | |
| 944 *:popup* *:popu* | |
| 945 :popu[p] {name} Popup the menu {name}. The menu named must | |
| 946 have at least one subentry, but need not | |
| 947 appear on the menu-bar (see |hidden-menus|). | |
| 948 {only available for Win32 and GTK GUI} | |
| 949 | |
| 398 | 950 :popu[p]! {name} Like above, but use the position of the mouse |
| 951 pointer instead of the cursor. | |
| 952 | |
| 7 | 953 Example: > |
| 954 :popup File | |
| 398 | 955 will make the "File" menu (if there is one) appear at the text cursor (mouse |
| 956 pointer if ! was used). > | |
| 7 | 957 |
| 958 :amenu ]Toolbar.Make :make<CR> | |
| 959 :popup ]Toolbar | |
| 960 This creates a popup menu that doesn't exist on the main menu-bar. | |
| 961 | |
| 962 Note that a menu that starts with ']' will not be displayed. | |
| 963 | |
| 964 ============================================================================== | |
| 965 6. Extras *gui-extras* | |
| 966 | |
| 967 This section describes other features which are related to the GUI. | |
| 968 | |
| 969 - With the GUI, there is no wait for one second after hitting escape, because | |
| 970 the key codes don't start with <Esc>. | |
| 971 | |
| 972 - Typing ^V followed by a special key in the GUI will insert "<Key>", since | |
| 973 the internal string used is meaningless. Modifiers may also be held down to | |
| 974 get "<Modifiers-Key>". | |
| 975 | |
| 976 - In the GUI, the modifiers SHIFT, CTRL, and ALT (or META) may be used within | |
| 236 | 977 mappings of special keys and mouse events. E.g.: :map <M-LeftDrag> <LeftDrag> |
| 7 | 978 |
| 979 - In the GUI, several normal keys may have modifiers in mappings etc, these | |
| 980 are <Space>, <Tab>, <NL>, <CR>, <Esc>. | |
| 981 | |
| 982 - To check in a Vim script if the GUI is being used, you can use something | |
| 983 like this: > | |
| 984 | |
| 985 if has("gui_running") | |
| 986 echo "yes, we have a GUI" | |
| 987 else | |
| 988 echo "Boring old console" | |
| 989 endif | |
| 8 | 990 < *setting-guifont* |
| 991 - When you use the same vimrc file on various systems, you can use something | |
| 992 like this to set options specifically for each type of GUI: > | |
| 993 | |
| 994 if has("gui_running") | |
| 995 if has("gui_gtk2") | |
| 996 :set guifont=Luxi\ Mono\ 12 | |
| 997 elseif has("x11") | |
| 998 " Also for GTK 1 | |
| 999 :set guifont=*-lucidatypewriter-medium-r-normal-*-*-180-*-*-m-*-* | |
| 1000 elseif has("gui_win32") | |
| 1001 :set guifont=Luxi_Mono:h12:cANSI | |
| 1002 endif | |
| 1003 endif | |
| 7 | 1004 |
| 678 | 1005 A recommended Japanese font is MS Mincho. You can find info here: |
| 1006 http://www.lexikan.com/mincho.htm | |
| 1007 | |
| 7 | 1008 ============================================================================== |
| 1009 7. Shell Commands *gui-shell* | |
| 1010 | |
| 1011 For the X11 GUI the external commands are executed inside the gvim window. | |
| 1012 See |gui-pty|. | |
| 1013 | |
| 1014 WARNING: Executing an external command from the X11 GUI will not always | |
| 1015 work. "normal" commands like "ls", "grep" and "make" mostly work fine. | |
| 1016 Commands that require an intelligent terminal like "less" and "ispell" won't | |
| 1017 work. Some may even hang and need to be killed from another terminal. So be | |
| 1018 careful! | |
| 1019 | |
| 1020 For the Win32 GUI the external commands are executed in a separate window. | |
| 1021 See |gui-shell-win32|. | |
| 1022 | |
| 1023 vim:tw=78:sw=4:ts=8:ft=help:norl: |