|
5294
|
1 *gui_w32.txt* For Vim version 7.4. Last change: 2012 Aug 04
|
|
7
|
2
|
|
|
3
|
|
|
4 VIM REFERENCE MANUAL by Bram Moolenaar
|
|
|
5
|
|
|
6
|
|
|
7 Vim's Win32 Graphical User Interface *gui-w32* *win32-gui*
|
|
|
8
|
|
|
9 1. Starting the GUI |gui-w32-start|
|
|
|
10 2. Vim as default editor |vim-default-editor|
|
|
|
11 3. Using the clipboard |gui-clipboard|
|
|
|
12 4. Shell Commands |gui-shell-win32|
|
|
|
13 5. Special colors |win32-colors|
|
|
|
14 6. Windows dialogs & browsers |gui-w32-dialogs|
|
|
|
15 7. Command line arguments |gui-w32-cmdargs|
|
|
|
16 8. Various |gui-w32-various|
|
|
|
17
|
|
|
18 Other relevant documentation:
|
|
|
19 |gui.txt| For generic items of the GUI.
|
|
4098
|
20 |os_win32.txt| For Win32 specific items.
|
|
7
|
21
|
|
|
22 {Vi does not have a Windows GUI}
|
|
|
23
|
|
|
24 ==============================================================================
|
|
|
25 1. Starting the GUI *gui-w32-start*
|
|
|
26
|
|
|
27 The Win32 GUI version of Vim will always start the GUI, no matter how you
|
|
|
28 start it or what it's called.
|
|
|
29
|
|
|
30 The GUI will always run in the Windows subsystem. Mostly shells automatically
|
|
|
31 return with a command prompt after starting gvim. If not, you should use the
|
|
|
32 "start" command: >
|
|
|
33 start gvim [options] file ..
|
|
|
34
|
|
|
35 Note: All fonts (bold, italic) must be of the same size!!! If you don't do
|
|
|
36 this, text will disappear or mess up the display. Vim does not check the font
|
|
|
37 sizes. It's the size in screen pixels that must be the same. Note that some
|
|
|
38 fonts that have the same point size don't have the same pixel size!
|
|
|
39 Additionally, the positioning of the fonts must be the same (ascent and
|
|
|
40 descent).
|
|
|
41
|
|
|
42 The Win32 GUI has an extra menu item: "Edit/Select Font". It brings up the
|
|
|
43 standard Windows font selector.
|
|
|
44
|
|
|
45 Setting the menu height doesn't work for the Win32 GUI.
|
|
|
46
|
|
|
47 *gui-win32-maximized*
|
|
|
48 If you want Vim to start with a maximized window, add this command to your
|
|
|
49 vimrc or gvimrc file: >
|
|
|
50 au GUIEnter * simalt ~x
|
|
|
51 <
|
|
|
52 *gui-w32s*
|
|
|
53 There is a specific version of gvim.exe that runs under the Win32s subsystem
|
|
|
54 of Windows 3.1 or 3.11. See |win32s|.
|
|
|
55
|
|
1376
|
56
|
|
|
57 Using Vim as a plugin *gui-w32-windowid*
|
|
|
58
|
|
|
59 When gvim starts up normally, it creates its own top level window. If you
|
|
|
60 pass Vim the command-line option |--windowid| with a decimal or hexadecimal
|
|
|
61 value, Vim will create a window that is a child of the window with the given
|
|
|
62 ID. This enables Vim to act as a plugin in another application. This really
|
|
|
63 is a programmer's interface, and is of no use without a supporting application
|
|
|
64 to spawn Vim correctly.
|
|
|
65
|
|
7
|
66 ==============================================================================
|
|
|
67 2. Vim as default editor *vim-default-editor*
|
|
|
68
|
|
|
69 To set Vim as the default editor for a file type:
|
|
|
70 1. Start a Windows Explorer
|
|
236
|
71 2. Choose View/Options -> File Types
|
|
7
|
72 3. Select the path to gvim for every file type that you want to use it for.
|
|
|
73 (you can also use three spaces in the file type field, for files without an
|
|
|
74 extension).
|
|
|
75 In the "open" action, use: >
|
|
|
76 gvim "%1"
|
|
|
77 < The quotes are required for using file names with embedded spaces.
|
|
|
78 You can also use this: >
|
|
|
79 gvim "%L"
|
|
|
80 < This should avoid short (8.3 character) file names in some situations. But
|
|
|
81 I'm not sure if this works everywhere.
|
|
|
82
|
|
|
83 When you open a file in Vim by double clicking it, Vim changes to that
|
|
|
84 file's directory.
|
|
|
85
|
|
|
86 If you want Vim to start full-screen, use this for the Open action: >
|
|
|
87 gvim -c "simalt ~x" "%1"
|
|
|
88
|
|
|
89 Another method, which also works when you put Vim in another directory (e.g.,
|
|
|
90 when you have got a new version):
|
|
|
91 1. select a file you want to use Vim with
|
|
|
92 2. <Shift-F10>
|
|
|
93 3. select "Open With..." menu entry
|
|
|
94 4. click "Other..."
|
|
|
95 5. browse to the (new) location of Vim and click "Open"
|
|
|
96 6. make "Always Use this program..." checked
|
|
|
97 7. <OK>
|
|
|
98
|
|
|
99 *send-to-menu* *sendto*
|
|
|
100 You can also install Vim in the "Send To" menu:
|
|
|
101 1. Start a Windows Explorer
|
|
|
102 2. Navigate to your sendto directory:
|
|
|
103 Windows 95: %windir%\sendto (e.g. "c:\windows\sendto")
|
|
|
104 Windows NT: %windir%\profiles\%user%\sendto (e.g.
|
|
|
105 "c:\winnt\profiles\mattha\sendto").
|
|
|
106 3. Right-click in the file pane and select New->Shortcut
|
|
|
107 4. Follow the shortcut wizard, using the full path to VIM/GVIM.
|
|
|
108
|
|
|
109 When you 'send a file to Vim', Vim changes to that file's directory. Note,
|
|
|
110 however, that any long directory names will appear in their short (MS-DOS)
|
|
|
111 form. This is a limitation of the Windows "Send To" mechanism.
|
|
|
112
|
|
|
113 *notepad*
|
|
|
114 You could replace notepad.exe with gvim.exe, but that has a few side effects.
|
|
|
115 Some programs rely on notepad arguments, which are not recognized by Vim. For
|
|
|
116 example "notepad -p" is used by some applications to print a file. It's
|
|
|
117 better to leave notepad where it is and use another way to start Vim.
|
|
|
118
|
|
|
119 *win32-popup-menu*
|
|
|
120 A more drastic approach is to install an "Edit with Vim" entry in the popup
|
|
|
121 menu for the right mouse button. With this you can edit any file with Vim.
|
|
|
122
|
|
|
123 This can co-exist with the file associations mentioned above. The difference
|
|
|
124 is that the file associations will make starting Vim the default action. With
|
|
|
125 the "Edit with Vim" menu entry you can keep the existing file association for
|
|
|
126 double clicking on the file, and edit the file with Vim when you want. For
|
|
|
127 example, you can associate "*.mak" with your make program. You can execute
|
|
|
128 the makefile by double clicking it and use the "Edit with Vim" entry to edit
|
|
|
129 the makefile.
|
|
|
130
|
|
|
131 You can select any files and right-click to see a menu option called "Edit
|
|
1668
|
132 with gvim". Choosing this menu option will invoke gvim with the file you have
|
|
7
|
133 selected. If you select multiple files, you will find two gvim-related menu
|
|
|
134 options:
|
|
|
135 "Edit with multiple gvims" -- one gvim for each file in the selection
|
|
|
136 "Edit with single gvim" -- one gvim for all the files in the selection
|
|
|
137 And if there already is a gvim running:
|
|
|
138 "Edit with existing gvim" -- edit the file with the running gvim
|
|
|
139
|
|
3082
|
140 The "edit with existing Vim" entries can be disabled by adding an entry in the
|
|
|
141 registry under HKLM\Software\Vim\Gvim, named DisableEditWithExisting, and with
|
|
|
142 any value.
|
|
7
|
143 *install-registry*
|
|
|
144 You can add the "Edit with Vim" menu entry in an easy way by using the
|
|
|
145 "install.exe" program. It will add several registry entries for you.
|
|
|
146
|
|
|
147 You can also do this by hand. This is complicated! Use the install.exe if
|
|
|
148 you can.
|
|
|
149
|
|
|
150 1. Start the registry editor with "regedit".
|
|
|
151 2. Add these keys:
|
|
|
152 key value name value ~
|
|
|
153 HKEY_CLASSES_ROOT\CLSID\{51EEE242-AD87-11d3-9C1E-0090278BBD99}
|
|
|
154 {default} Vim Shell Extension
|
|
|
155 HKEY_CLASSES_ROOT\CLSID\{51EEE242-AD87-11d3-9C1E-0090278BBD99}\InProcServer32
|
|
|
156 {default} {path}\gvimext.dll
|
|
|
157 ThreadingModel Apartment
|
|
|
158 HKEY_CLASSES_ROOT\*\shellex\ContextMenuHandlers\gvim
|
|
|
159 {default} {51EEE242-AD87-11d3-9C1E-0090278BBD99}
|
|
|
160 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Shell Extensions\Approved
|
|
|
161 {51EEE242-AD87-11d3-9C1E-0090278BBD99}
|
|
|
162 Vim Shell Extension
|
|
|
163 HKEY_LOCAL_MACHINE\Software\Vim\Gvim
|
|
|
164 path {path}\gvim.exe
|
|
|
165 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\vim 5.6
|
|
|
166 DisplayName Vim 5.6: Edit with Vim popup menu entry
|
|
|
167 UninstallString {path}\uninstal.exe
|
|
|
168
|
|
|
169 Replace {path} with the path that leads to the executable.
|
|
|
170 Don't type {default}, this is the value for the key itself.
|
|
|
171
|
|
|
172 To remove "Edit with Vim" from the popup menu, just remove the registry
|
|
|
173 entries mentioned above. The "uninstal.exe" program can do this for you. You
|
|
|
174 can also use the entry in the Windows standard "Add/Remove Programs" list.
|
|
|
175
|
|
|
176 If you notice that this entry overrules other file type associations, set
|
|
|
177 those associations again by hand (using Windows Explorer, see above). This
|
|
|
178 only seems to happen on some Windows NT versions (Windows bug?). Procedure:
|
|
|
179 1. Find the name of the file type. This can be done by starting the registry
|
|
|
180 editor, and searching for the extension in \\HKEY_CLASSES_ROOT
|
|
|
181 2. In a Windows Explorer, use View/Options/File Types. Search for the file
|
|
|
182 type in the list and click "Edit". In the actions list, you can select on
|
|
|
183 to be used as the default (normally the "open" action) and click on the
|
|
|
184 "Set Default" button.
|
|
|
185
|
|
|
186
|
|
|
187 Vim in the "Open With..." context menu *win32-open-with-menu*
|
|
|
188
|
|
|
189 If you use the Vim install program you have the choice to add Vim to the "Open
|
|
|
190 With..." menu. This means you can use Vim to edit many files. Not every file
|
|
|
191 (for unclear reasons...), thus the "Edit with Vim" menu entry is still useful.
|
|
|
192
|
|
|
193 One reason to add this is to be able to edit HTML files directly from Internet
|
|
|
194 Explorer. To enable this use the "Tools" menu, "Internet Options..." entry.
|
|
|
195 In the dialog select the "Programs" tab and select Vim in the "HTML editor"
|
|
|
196 choice. If it's not there than installing didn't work properly.
|
|
|
197
|
|
|
198 Doing this manually can be done with this script:
|
|
|
199
|
|
|
200 ----------------------------------------------------------
|
|
|
201 REGEDIT4
|
|
|
202
|
|
|
203 [HKEY_CLASSES_ROOT\Applications\gvim.exe]
|
|
|
204
|
|
|
205 [HKEY_CLASSES_ROOT\Applications\gvim.exe\shell]
|
|
|
206
|
|
|
207 [HKEY_CLASSES_ROOT\Applications\gvim.exe\shell\edit]
|
|
|
208
|
|
|
209 [HKEY_CLASSES_ROOT\Applications\gvim.exe\shell\edit\command]
|
|
|
210 @="c:\\vim\\vim62\\gvim.exe \"%1\""
|
|
|
211
|
|
|
212 [HKEY_CLASSES_ROOT\.htm\OpenWithList\gvim.exe]
|
|
|
213
|
|
|
214 [HKEY_CLASSES_ROOT\*\OpenWithList\gvim.exe]
|
|
|
215
|
|
|
216 ----------------------------------------------------------
|
|
|
217
|
|
|
218 Change the "c:\\vim\\vim62" bit to where gvim.exe is actually located.
|
|
|
219
|
|
|
220 To uninstall this run the Vim uninstall program or manually delete the
|
|
|
221 registry entries with "regedit".
|
|
|
222
|
|
|
223 ==============================================================================
|
|
|
224 3. Using the clipboard *gui-clipboard*
|
|
|
225
|
|
|
226 Windows has a clipboard, where you can copy text to, and paste text from. Vim
|
|
|
227 supports this in several ways. For other systems see |gui-selections|.
|
|
|
228
|
|
|
229 The "* register reflects the contents of the clipboard. |quotestar|
|
|
|
230
|
|
|
231 When the "unnamed" string is included in the 'clipboard' option, the unnamed
|
|
|
232 register is the same. Thus you can yank to and paste from the clipboard
|
|
|
233 without prepending "* to commands.
|
|
|
234
|
|
|
235 The 'a' flag in 'guioptions' is not included by default. This means that text
|
|
|
236 is only put on the clipboard when an operation is performed on it. Just
|
|
|
237 Visually selecting text doesn't put it on the clipboard. When the 'a' flag is
|
|
|
238 included, the text is copied to the clipboard even when it is not operated
|
|
|
239 upon.
|
|
|
240
|
|
|
241 *mswin.vim*
|
|
|
242 To use the standard MS-Windows way of CTRL-X, CTRL-C and CTRL-V, use the
|
|
|
243 $VIMRUNTIME/mswin.vim script. You could add this line to your _vimrc file: >
|
|
|
244 source $VIMRUNTIME/mswin.vim
|
|
|
245
|
|
|
246 Since CTRL-C is used to copy the text to the clipboard, it can't be used to
|
|
|
247 cancel an operation. Use CTRL-Break for that.
|
|
|
248
|
|
1121
|
249 CTRL-Z is used for undo. This means you can't suspend Vim with this key, use
|
|
|
250 |:suspend| instead (if it's supported at all).
|
|
81
|
251
|
|
167
|
252 *CTRL-V-alternative* *CTRL-Q*
|
|
7
|
253 Since CTRL-V is used to paste, you can't use it to start a blockwise Visual
|
|
|
254 selection. You can use CTRL-Q instead. You can also use CTRL-Q in Insert
|
|
|
255 mode and Command-line mode to get the old meaning of CTRL-V. But CTRL-Q
|
|
|
256 doesn't work for terminals when it's used for control flow.
|
|
|
257
|
|
|
258 NOTE: The clipboard support still has a number of bugs. See |todo|.
|
|
|
259
|
|
|
260 ==============================================================================
|
|
|
261 4. Shell Commands *gui-shell-win32*
|
|
|
262
|
|
|
263 Vim uses another window for external commands, to make it possible to run any
|
|
|
264 command. The external command gets its own environment for running, just like
|
|
|
265 it was started from a DOS prompt.
|
|
|
266
|
|
|
267 *win32-vimrun*
|
|
|
268 Executing an external command is done indirectly by the "vimrun" command. The
|
|
|
269 "vimrun.exe" must be in the path for this to work. Or it must be in the same
|
|
|
270 directory as the Vim executable. If "vimrun" cannot be found, the command is
|
|
|
271 executed directly, but then the DOS window closes immediately after the
|
|
|
272 external command has finished.
|
|
|
273 WARNING: If you close this window with the "X" button, and confirm the
|
|
|
274 question if you really want to kill the application, Vim may be killed too!
|
|
|
275 (This does not apply to commands run asynchronously with ":!start".)
|
|
|
276
|
|
|
277 In Windows 95, the window in which the commands are executed is always 25x80
|
|
|
278 characters, to be as DOS compatible as possible (this matters!). The default
|
|
236
|
279 system font is used. On NT, the window will be the default you have set up for
|
|
|
280 "Console" in Control Panel. On Win32s, the properties of the DOS box are
|
|
7
|
281 determined by _default.pif in the windows directory.
|
|
|
282
|
|
|
283 *msdos-mode*
|
|
|
284 If you get a dialog that says "This program is set to run in MS-DOS mode..."
|
|
|
285 when you run an external program, you can solve this by changing the
|
|
|
286 properties of the associated shortcut:
|
|
|
287 - Use a Windows Explorer to find the command.com that is used. It can be
|
|
|
288 c:\command.com, c:\dos\command.com, c:\windows\command.com, etc.
|
|
|
289 - With the right mouse button, select properties of this command.com.
|
|
|
290 - In the Program tab select "Advanced".
|
|
|
291 - Unselect "MS-DOS mode".
|
|
|
292 - Click "OK" twice.
|
|
|
293
|
|
|
294 *win32-!start*
|
|
|
295 Normally, Vim waits for a command to complete before continuing (this makes
|
|
|
296 sense for most shell commands which produce output for Vim to use). If you
|
|
|
297 want Vim to start a program and return immediately, you can use the following
|
|
|
298 syntax on W95 & NT: >
|
|
2681
|
299 :!start [/min] {command}
|
|
|
300 The optional "/min" causes the window to be minimized.
|
|
|
301
|
|
236
|
302 On Win32s, you will have to go to another window instead. Don't forget that
|
|
7
|
303 you must tell Windows 3.1x to keep executing a DOS command in the background
|
|
|
304 while you switch back to Vim.
|
|
|
305
|
|
|
306 ==============================================================================
|
|
|
307 5. Special colors *win32-colors*
|
|
|
308
|
|
|
309 On Win32, the normal DOS colors can be used. See |dos-colors|.
|
|
|
310
|
|
|
311 Additionally the system configured colors can also be used. These are known
|
|
|
312 by the names Sys_XXX, where XXX is the appropriate system color name, from the
|
|
|
313 following list (see the Win32 documentation for full descriptions). Case is
|
|
236
|
314 ignored. Note: On Win32s not all of these colors are supported.
|
|
7
|
315
|
|
|
316 Sys_3DDKShadow Sys_3DFace Sys_BTNFace
|
|
|
317 Sys_3DHilight Sys_3DHighlight Sys_BTNHilight
|
|
|
318 Sys_BTNHighlight Sys_3DLight Sys_3DShadow
|
|
|
319 Sys_BTNShadow Sys_ActiveBorder Sys_ActiveCaption
|
|
|
320 Sys_AppWorkspace Sys_Background Sys_Desktop
|
|
|
321 Sys_BTNText Sys_CaptionText Sys_GrayText
|
|
|
322 Sys_Highlight Sys_HighlightText Sys_InactiveBorder
|
|
|
323 Sys_InactiveCaption Sys_InactiveCaptionText Sys_InfoBK
|
|
|
324 Sys_InfoText Sys_Menu Sys_MenuText
|
|
|
325 Sys_ScrollBar Sys_Window Sys_WindowFrame
|
|
|
326 Sys_WindowText
|
|
|
327
|
|
|
328 Probably the most useful values are
|
|
|
329 Sys_Window Normal window background
|
|
|
330 Sys_WindowText Normal window text
|
|
|
331 Sys_Highlight Highlighted background
|
|
|
332 Sys_HighlightText Highlighted text
|
|
|
333
|
|
|
334 These extra colors are also available:
|
|
|
335 Gray, Grey, LightYellow, SeaGreen, Orange, Purple, SlateBlue, Violet,
|
|
|
336
|
|
|
337 *rgb.txt*
|
|
|
338 Additionally, colors defined by a "rgb.txt" file can be used. This file is
|
|
|
339 well known from X11. A few lines from it: >
|
|
|
340
|
|
|
341 255 218 185 peach puff
|
|
|
342 205 133 63 peru
|
|
|
343 255 181 197 pink
|
|
|
344
|
|
|
345 This shows the layout of the file: First the R, G and B value as a decimal
|
|
|
346 number, followed by the name of the color. The four fields are separated by
|
|
|
347 spaces.
|
|
|
348
|
|
|
349 You can get an rgb.txt file from any X11 distribution. It is located in a
|
|
|
350 directory like "/usr/X11R6/lib/X11/". For Vim it must be located in the
|
|
|
351 $VIMRUNTIME directory. Thus the file can be found with "$VIMRUNTIME/rgb.txt".
|
|
|
352
|
|
|
353 ==============================================================================
|
|
|
354 *gui-w32-dialogs* *dialog*
|
|
|
355 6. Windows dialogs & browsers
|
|
|
356
|
|
|
357 The Win32 GUI can use familiar Windows components for some operations, as well
|
|
|
358 as the traditional interface shared with the console version.
|
|
|
359
|
|
|
360
|
|
|
361 6.1 Dialogs
|
|
|
362
|
|
|
363 The dialogs displayed by the "confirm" family (i.e. the 'confirm' option,
|
|
|
364 |:confirm| command and |confirm()| function) are GUI-based rather than the
|
|
|
365 console-based ones used by other versions. The 'c' flag in 'guioptions'
|
|
|
366 changes this.
|
|
|
367
|
|
|
368
|
|
|
369 6.2 File Browsers
|
|
|
370
|
|
|
371 When prepending ":browse" before file editing commands, a file requester is
|
|
|
372 used to allow you to select an existing file. See |:browse|.
|
|
|
373
|
|
|
374
|
|
|
375 6.3 Tearoff Menus
|
|
|
376
|
|
|
377 The Win32 GUI emulates Motif's tear-off menus. At the top of each menu you
|
|
|
378 will see a small graphic "rip here" sign. Selecting it will cause a floating
|
|
|
379 window to be created with the same menu entries on it. The floating menu can
|
|
|
380 then be accessed just as if it was the original (including sub-menus), but
|
|
|
381 without having to go to the menu bar each time.
|
|
|
382 This is most useful if you find yourself using a command buried in a sub-menu
|
|
|
383 over and over again.
|
|
|
384 The tearoff menus can be positioned where you like, and always stay just above
|
|
236
|
385 the Main Vim window. You can get rid of them by closing them as usual; they
|
|
7
|
386 also of course close when you exit Vim.
|
|
|
387
|
|
|
388 *:tearoff* *:te*
|
|
|
389 :te[aroff] {name} Tear-off the menu {name}. The menu named must have at
|
|
|
390 least one subentry, but need not appear on the
|
|
|
391 menu-bar (see |win32-hidden-menus|).
|
|
|
392
|
|
|
393 Example: >
|
|
|
394 :tearoff File
|
|
|
395 will make the "File" menu (if there is one) appear as a tearoff menu. >
|
|
|
396
|
|
|
397 :amenu ]Toolbar.Make :make<CR>
|
|
|
398 :tearoff ]Toolbar
|
|
|
399 This creates a floating menu that doesn't exist on the main menu-bar.
|
|
|
400
|
|
|
401 Note that a menu that starts with ']' will not be displayed.
|
|
|
402
|
|
|
403 ==============================================================================
|
|
|
404 7. Command line arguments *gui-w32-cmdargs*
|
|
|
405
|
|
|
406 Analysis of a command line into parameters is not standardised in MS Windows.
|
|
|
407 Gvim has to provide logic to analyse a command line. This logic is likely to
|
|
|
408 be different from the default logic provided by a compilation system used to
|
|
|
409 build vim. The differences relate to unusual double quote (") usage.
|
|
|
410 The arguments "C:\My Music\freude.txt" and "+/Sch\"iller" are handled in the
|
|
|
411 same way. The argument "+/Sch""iller" may be handled different by gvim and
|
|
|
412 vim, depending what it was compiled with.
|
|
|
413
|
|
|
414 The rules are:
|
|
|
415 a) A parameter is a sequence of graphic characters.
|
|
|
416 b) Parameters are separated by white space.
|
|
|
417 c) A parameter can be enclosed in double quotes to include white space.
|
|
|
418 d) A sequence of zero or more backslashes (\) and a double quote (")
|
|
236
|
419 is special. The effective number of backslashes is halved, rounded
|
|
7
|
420 down. An even number of backslashes reverses the acceptability of
|
|
|
421 spaces and tabs, an odd number of backslashes produces a literal
|
|
|
422 double quote.
|
|
|
423
|
|
|
424 So:
|
|
|
425 " is a special double quote
|
|
|
426 \" is a literal double quote
|
|
|
427 \\" is a literal backslash and a special double quote
|
|
|
428 \\\" is a literal backslash and a literal double quote
|
|
|
429 \\\\" is 2 literal backslashes and a special double quote
|
|
|
430 \\\\\" is 2 literal backslashes and a literal double quote
|
|
|
431 etc.
|
|
|
432
|
|
|
433 Example: >
|
|
|
434 gvim "C:\My Music\freude" +"set ignorecase" +/"\"foo\\" +\"bar\\\"
|
|
|
435
|
|
|
436 opens "C:\My Music\freude" and executes the line mode commands: >
|
|
|
437 set ignorecase; /"foo\ and /bar\"
|
|
|
438
|
|
|
439 ==============================================================================
|
|
|
440 8. Various *gui-w32-various*
|
|
|
441
|
|
|
442 *gui-w32-printing*
|
|
|
443 The "File/Print" menu prints the text with syntax highlighting, see
|
|
|
444 |:hardcopy|. If you just want to print the raw text and have a default
|
|
|
445 printer installed this should also work: >
|
|
|
446 :w >>prn
|
|
|
447
|
|
236
|
448 Vim supports a number of standard MS Windows features. Some of these are
|
|
7
|
449 detailed elsewhere: see |'mouse'|, |win32-hidden-menus|.
|
|
|
450
|
|
|
451 *drag-n-drop-win32*
|
|
|
452 You can drag and drop one or more files into the Vim window, where they will
|
|
|
453 be opened as normal. See |drag-n-drop|.
|
|
|
454
|
|
|
455 *:simalt* *:si*
|
|
|
456 :sim[alt] {key} simulate pressing {key} while holding Alt pressed.
|
|
|
457 {not in Vi} {only for Win32 versions}
|
|
|
458
|
|
|
459 Normally, Vim takes control of all Alt-<Key> combinations, to increase the
|
|
236
|
460 number of possible mappings. This clashes with the standard use of Alt as the
|
|
7
|
461 key for accessing menus.
|
|
|
462 The quick way of getting standard behavior is to set the 'winaltkeys' option
|
|
|
463 to "yes". This however prevents you from mapping Alt keys at all.
|
|
|
464 Another way is to set 'winaltkeys' to "menu". Menu shortcut keys are then
|
|
|
465 handled by windows, other ALT keys can be mapped. This doesn't allow a
|
|
|
466 dependency on the current state though.
|
|
|
467 To get round this, the :simalt command allows Vim (when 'winaltkeys' is not
|
|
236
|
468 "yes") to fake a Windows-style Alt keypress. You can use this to map Alt key
|
|
7
|
469 combinations (or anything else for that matter) to produce standard Windows
|
|
236
|
470 actions. Here are some examples: >
|
|
7
|
471
|
|
|
472 :map <M-f> :simalt f<CR>
|
|
|
473 This makes Alt-F pop down the 'File' menu (with the stock Menu.vim) by
|
|
|
474 simulating the keystrokes Alt, F. >
|
|
|
475 :map <M-Space> :simalt ~<CR>
|
|
236
|
476 This maps Alt-Space to pop down the system menu for the Vim window. Note that
|
|
7
|
477 ~ is used by simalt to represent the <Space> character. >
|
|
|
478 :map <C-n> :simalt ~n<CR>
|
|
236
|
479 Maps Control-N to produce the keys Alt-Space followed by N. This minimizes the
|
|
7
|
480 Vim window via the system menu.
|
|
|
481
|
|
1121
|
482 Note that the key changes depending on the language you are using.
|
|
|
483
|
|
7
|
484 *intellimouse-wheel-problems*
|
|
|
485 When using the Intellimouse mouse wheel causes Vim to stop accepting input, go
|
|
|
486 to:
|
|
|
487 ControlPanel - Mouse - Wheel - UniversalScrolling - Exceptions
|
|
|
488
|
|
|
489 And add gvim to the list of applications. This problem only appears to happen
|
|
|
490 with the Intellimouse driver 2.2 and when "Universal Scrolling" is turned on.
|
|
|
491
|
|
3750
|
492
|
|
|
493 XPM support *w32-xpm-support*
|
|
|
494
|
|
|
495 Gvim can be build on MS-Windows with support for XPM files. |+xpm_w32|
|
|
|
496 See the Make_mvc.mak file for instructions, search for XPM.
|
|
|
497
|
|
|
498 To try out if XPM support works do this: >
|
|
|
499 :help
|
|
|
500 :exe 'sign define vimxpm icon=' . $VIMRUNTIME . '\\vim16x16.xpm'
|
|
|
501 :exe 'sign place 1 line=1 name=vimxpm file=' . expand('%:p')
|
|
|
502 <
|
|
|
503
|
|
7
|
504 vim:tw=78:sw=4:ts=8:ft=help:norl:
|
