|
1702
|
1 *gui_w16.txt* For Vim version 7.2. Last change: 2005 Mar 29
|
|
7
|
2
|
|
|
3
|
|
|
4 VIM REFERENCE MANUAL by Bram Moolenaar
|
|
|
5
|
|
|
6
|
|
|
7 Vim's Graphical User Interface *gui-w16* *win16-gui*
|
|
|
8
|
|
|
9 1. Starting the GUI |win16-start|
|
|
|
10 2. Vim as default editor |win16-default-editor|
|
|
|
11 3. Using the clipboard |win16-clipboard|
|
|
|
12 4. Shell Commands |win16-shell|
|
|
|
13 5. Special colors |win16-colors|
|
|
|
14 6. Windows dialogs & browsers |win16-dialogs|
|
|
|
15 7. Various |win16-various|
|
|
|
16
|
|
|
17 Other relevant documentation:
|
|
|
18 |gui.txt| For generic items of the GUI.
|
|
|
19 |os_msdos.txt| For items common to DOS and Windows.
|
|
|
20 |gui_w32.txt| Some items here are also applicable to the Win16 version.
|
|
|
21
|
|
|
22 {Vi does not have a Windows GUI}
|
|
|
23
|
|
236
|
24 The Win16 version of Vim will run on Windows 3.1 or later. It has not been
|
|
7
|
25 tested on 3.0, it probably won't work without being recompiled and
|
|
236
|
26 modified. (But you really should upgrade to 3.11 anyway. :)
|
|
7
|
27
|
|
|
28 In most respects it behaves identically to the Win32 GUI version, including
|
|
236
|
29 having a flat-style toolbar(!). The chief differences:
|
|
7
|
30
|
|
|
31 1) Bold/Italic text is not available, to speed up repaint/reduce resource
|
|
236
|
32 usage. (You can re-instate this by undefining MSWIN16_FASTTEXT.)
|
|
7
|
33 2) No tearoff menu emulation.
|
|
|
34 3) No OLE interface.
|
|
236
|
35 4) No long filename support (of course).
|
|
7
|
36 5) No tooltips on toolbar buttons - instead they produce command-line tips
|
|
|
37 like menu items do.
|
|
236
|
38 6) Line length limited to 32767 characters (like 16-bit DOS version).
|
|
7
|
39
|
|
|
40
|
|
|
41 ==============================================================================
|
|
|
42 1. Starting the GUI *win16-start*
|
|
|
43
|
|
|
44 The Win16 GUI version of Vim will always start the GUI, no matter how you
|
|
236
|
45 start it or what it's called. There is no 'console' version as such, but you
|
|
7
|
46 can use one of the DOS versions in a DOS box.
|
|
|
47
|
|
|
48 The Win16 GUI has an extra menu item: "Window/Select Font". It brings up the
|
|
236
|
49 standard Windows font selector. Note that bold and italic fonts are not
|
|
7
|
50 supported in an attempt to maximize GDI drawing speed.
|
|
|
51
|
|
|
52 Setting the menu height doesn't work for the Win16 GUI.
|
|
|
53
|
|
|
54 *win16-maximized*
|
|
|
55 If you want Vim to start with a maximized window, add this command to your
|
|
|
56 vimrc or gvimrc file: >
|
|
|
57 au GUIEnter * simalt ~x
|
|
|
58 <
|
|
|
59
|
|
|
60 There is a specific version of gvim.exe that runs under the Win32s subsystem
|
|
|
61 of Windows 3.1 or 3.11. See |win32s|.
|
|
|
62
|
|
|
63 ==============================================================================
|
|
|
64 2. Vim as default editor *win16-default-editor*
|
|
|
65
|
|
|
66 To set Vim as the default editor for a file type you can use File Manager's
|
|
|
67 "Associate" feature.
|
|
|
68
|
|
|
69 When you open a file in Vim by double clicking it, Vim changes to that
|
|
|
70 file's directory.
|
|
|
71
|
|
|
72 See also |notepad|.
|
|
|
73
|
|
|
74 ==============================================================================
|
|
|
75 3. Using the clipboard *win16-clipboard*
|
|
|
76
|
|
|
77 Windows has a clipboard, where you can copy text to, and paste text from. Vim
|
|
|
78 supports this in several ways.
|
|
|
79 The clipboard works in the same way as the Win32 version: see |gui-clipboard|.
|
|
|
80
|
|
|
81 ==============================================================================
|
|
|
82 4. Shell Commands *win16-shell*
|
|
|
83
|
|
|
84 Vim spawns a DOS window for external commands, to make it possible to run any
|
|
236
|
85 DOS command. The window uses the _default.pif settings.
|
|
7
|
86
|
|
|
87 *win16-!start*
|
|
|
88 Normally, Vim waits for a command to complete before continuing (this makes
|
|
|
89 sense for most shell commands which produce output for Vim to use). If you
|
|
|
90 want Vim to start a program and return immediately, you can use the following
|
|
|
91 syntax:
|
|
|
92 :!start {command}
|
|
|
93 This may only work for a Windows program though.
|
|
|
94 Don't forget that you must tell Windows 3.1x to keep executing a DOS command
|
|
|
95 in the background while you switch back to Vim.
|
|
|
96
|
|
|
97 ==============================================================================
|
|
|
98 5. Special colors *win16-colors*
|
|
|
99
|
|
|
100 On Win16, the normal DOS colors can be used. See |dos-colors|.
|
|
|
101
|
|
|
102 Additionally the system configured colors can also be used. These are known
|
|
|
103 by the names Sys_XXX, where XXX is the appropriate system color name, from the
|
|
|
104 following list (see the Win32 documentation for full descriptions). Case is
|
|
|
105 ignored.
|
|
|
106
|
|
|
107 Sys_BTNFace Sys_BTNShadow Sys_ActiveBorder
|
|
|
108 Sys_ActiveCaption Sys_AppWorkspace Sys_Background
|
|
|
109 Sys_BTNText Sys_CaptionText Sys_GrayText
|
|
|
110 Sys_Highlight Sys_HighlightText Sys_InactiveBorder
|
|
|
111 Sys_InactiveCaption Sys_InactiveCaptionText Sys_Menu
|
|
|
112 Sys_MenuText Sys_ScrollBar Sys_Window
|
|
|
113 Sys_WindowFrame Sys_WindowText
|
|
|
114
|
|
|
115 Probably the most useful values are
|
|
|
116 Sys_Window Normal window background
|
|
|
117 Sys_WindowText Normal window text
|
|
|
118 Sys_Highlight Highlighted background
|
|
|
119 Sys_HighlightText Highlighted text
|
|
|
120
|
|
|
121 These extra colors are also available:
|
|
|
122 Gray, Grey, LightYellow, SeaGreen, Orange, Purple, SlateBlue, Violet,
|
|
|
123
|
|
|
124
|
|
|
125 See also |rgb.txt|.
|
|
|
126
|
|
|
127 ==============================================================================
|
|
|
128 *win16-dialogs*
|
|
|
129 6. Windows dialogs & browsers
|
|
|
130
|
|
|
131 The Win16 GUI can use familiar Windows components for some operations, as well
|
|
|
132 as the traditional interface shared with the console version.
|
|
|
133
|
|
|
134
|
|
|
135 6.1 Dialogs
|
|
|
136
|
|
|
137 The dialogs displayed by the "confirm" family (i.e. the 'confirm' option,
|
|
236
|
138 |:confirm| command and |confirm()| function) are GUI-based rather than the
|
|
7
|
139 console-based ones used by other versions. There is no option to change this.
|
|
|
140
|
|
|
141
|
|
|
142 6.2 File Browsers
|
|
|
143
|
|
|
144 When prepending ":browse" before file editing commands, a file requester is
|
|
|
145 used to allow you to select an existing file. See |:browse|.
|
|
|
146
|
|
|
147
|
|
|
148 ==============================================================================
|
|
|
149 7. Various *win16-various*
|
|
|
150
|
|
|
151 *win16-printing*
|
|
|
152 The "File/Print" menu uses Notepad to print the current buffer. This is a bit
|
|
|
153 clumsy, but it's portable. If you want something else, you can define your
|
|
|
154 own print command. For example, you could look for the 16-bit version of
|
|
|
155 PrintFile. See $VIMRUNTIME/menu.vim for how it works by default.
|
|
|
156
|
|
|
157 Using this should also work: >
|
|
|
158 :w >>prn
|
|
|
159
|
|
236
|
160 Vim supports a number of standard MS Windows features. Some of these are
|
|
7
|
161 detailed elsewhere: see |'mouse'|, |win32-hidden-menus|.
|
|
|
162 Also see |:simalt|
|
|
|
163
|
|
|
164 *win16-drag-n-drop*
|
|
|
165 You can drag and drop one or more files into the vim window, where they will
|
|
|
166 be opened as normal. If you hold down Shift while doing this, Vim changes to
|
|
|
167 the (first) dropped file's directory. If you hold Ctrl, Vim will always split
|
|
|
168 a new window for the file. Otherwise it's only done if the current buffer has
|
|
|
169 been changed.
|
|
|
170 You can also drop a directory's icon, but rather than open all files in the
|
|
|
171 directory (which wouldn't usually be what you want) Vim instead changes to
|
|
|
172 that directory and begins a new file.
|
|
|
173 If Vim happens to be editing a command line, the names of the dropped files
|
|
|
174 and directories will be inserted at the cursor. This allows you to use these
|
|
|
175 names with any Ex command.
|
|
|
176
|
|
|
177 *win16-truetype*
|
|
|
178 It is recommended that you use a raster font and not a TrueType
|
|
236
|
179 fixed-pitch font. E.g. use Courier, not Courier New. This is not just
|
|
7
|
180 to use less resources but because there are subtle bugs in the
|
|
236
|
181 handling of fixed-pitch TrueType in Win3.1x. In particular, when you move
|
|
7
|
182 a block cursor over a pipe character '|', the cursor is drawn in the wrong
|
|
236
|
183 size and bits get left behind. This is a bug in the Win3.1x GDI, it doesn't
|
|
7
|
184 happen if you run the exe under 95/NT.
|
|
|
185
|
|
|
186 vim:tw=78:sw=4:ts=8:ft=help:norl:
|
