Mercurial > vim
annotate runtime/doc/visual.txt @ 3736:dc65e6429d2c v7.3.627
updated for version 7.3.627
Problem: When using the "n" flag with the ":s" command a \= substitution
will not be evaluated.
Solution: Do perform the evaluation, so that a function can be invoked at
every matching position without changing the text. (Christian
Brabandt)
| author | Bram Moolenaar <bram@vim.org> |
|---|---|
| date | Wed, 08 Aug 2012 16:51:15 +0200 |
| parents | 9910cbff5f16 |
| children | 536aa8b0c934 |
| rev | line source |
|---|---|
| 3713 | 1 *visual.txt* For Vim version 7.3. Last change: 2012 Jul 25 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Bram Moolenaar | |
| 5 | |
| 6 | |
| 7 Visual mode *Visual* *Visual-mode* *visual-mode* | |
| 8 | |
| 9 Visual mode is a flexible and easy way to select a piece of text for an | |
| 10 operator. It is the only way to select a block of text. | |
| 11 | |
| 12 This is introduced in section |04.4| of the user manual. | |
| 13 | |
| 14 1. Using Visual mode |visual-use| | |
| 15 2. Starting and stopping Visual mode |visual-start| | |
| 16 3. Changing the Visual area |visual-change| | |
| 17 4. Operating on the Visual area |visual-operators| | |
| 18 5. Blockwise operators |blockwise-operators| | |
| 19 6. Repeating |visual-repeat| | |
| 20 7. Examples |visual-examples| | |
| 21 8. Select mode |Select-mode| | |
| 22 | |
| 23 {Vi has no Visual mode, the name "visual" is used for Normal mode, to | |
| 24 distinguish it from Ex mode} | |
| 25 {not available when the |+visual| feature was disabled when compiling} | |
| 26 | |
| 27 ============================================================================== | |
| 28 1. Using Visual mode *visual-use* | |
| 29 | |
| 30 Using Visual mode consists of three parts: | |
| 31 1. Mark the start of the text with "v", "V" or CTRL-V. | |
| 32 The character under the cursor will be used as the start. | |
| 33 2. Move to the end of the text. | |
| 34 The text from the start of the Visual mode up to and including the | |
| 35 character under the cursor is highlighted. | |
| 36 3. Type an operator command. | |
| 37 The highlighted characters will be operated upon. | |
| 38 | |
| 39 The 'highlight' option can be used to set the display mode to use for | |
| 40 highlighting in Visual mode. | |
| 41 The 'virtualedit' option can be used to allow positioning the cursor to | |
| 42 positions where there is no actual character. | |
| 43 | |
| 44 The highlighted text normally includes the character under the cursor. | |
| 45 However, when the 'selection' option is set to "exclusive" and the cursor is | |
| 46 after the Visual area, the character under the cursor is not included. | |
| 47 | |
| 48 With "v" the text before the start position and after the end position will | |
| 42 | 49 not be highlighted. However, all uppercase and non-alpha operators, except |
| 7 | 50 "~" and "U", will work on whole lines anyway. See the list of operators |
| 51 below. | |
| 52 | |
| 53 *visual-block* | |
| 54 With CTRL-V (blockwise Visual mode) the highlighted text will be a rectangle | |
| 55 between start position and the cursor. However, some operators work on whole | |
| 56 lines anyway (see the list below). The change and substitute operators will | |
| 57 delete the highlighted text and then start insertion at the top left | |
| 58 position. | |
| 59 | |
| 60 ============================================================================== | |
| 61 2. Starting and stopping Visual mode *visual-start* | |
| 62 | |
| 63 *v* *characterwise-visual* | |
| 3557 | 64 [count]v Start Visual mode per character. |
| 65 With [count] select that many characters, like moving | |
| 66 the cursor right [count] characters. One less when | |
| 67 'selection' is not "exclusive". | |
| 7 | 68 |
| 69 *V* *linewise-visual* | |
| 3557 | 70 [count]V Start Visual mode linewise. |
| 71 With [count] select that many lines. | |
| 7 | 72 |
| 73 *CTRL-V* *blockwise-visual* | |
| 3557 | 74 [count]CTRL-V Start Visual mode blockwise. Note: Under Windows |
| 7 | 75 CTRL-V could be mapped to paste text, it doesn't work |
| 76 to start Visual mode then, see |CTRL-V-alternative|. | |
| 3557 | 77 [count] is used as with `v` above. |
| 7 | 78 |
| 79 If you use <Esc>, click the left mouse button or use any command that | |
| 80 does a jump to another buffer while in Visual mode, the highlighting stops | |
| 81 and no text is affected. Also when you hit "v" in characterwise Visual mode, | |
| 82 "CTRL-V" in blockwise Visual mode or "V" in linewise Visual mode. If you hit | |
| 83 CTRL-Z the highlighting stops and the editor is suspended or a new shell is | |
| 84 started |CTRL-Z|. | |
| 85 | |
| 86 new mode after typing: *v_v* *v_CTRL-V* *v_V* | |
| 87 old mode "v" "CTRL-V" "V" ~ | |
| 88 | |
| 89 Normal Visual blockwise Visual linewise Visual | |
| 90 Visual Normal blockwise Visual linewise Visual | |
| 91 blockwise Visual Visual Normal linewise Visual | |
| 92 linewise Visual Visual blockwise Visual Normal | |
| 93 | |
| 548 | 94 *gv* *v_gv* *reselect-Visual* |
| 7 | 95 gv Start Visual mode with the same area as the previous |
| 236 | 96 area and the same mode. |
| 97 In Visual mode the current and the previous Visual | |
| 98 area are exchanged. | |
| 99 After using "p" or "P" in Visual mode the text that | |
| 100 was put will be selected. | |
| 7 | 101 |
| 3701 | 102 *gn* *v_gn* |
| 103 gn Search forward for the last used search pattern, like | |
| 104 with `n`, and start Visual mode to select the match. | |
| 105 If the cursor is on the match, visually selects it. | |
| 106 If an operator is pending, operates on the match. | |
| 107 E.g., "dgn" deletes the text of the next match. | |
| 108 If Visual mode is active, extends the selection | |
| 109 until the end of the next match. | |
| 110 | |
| 111 *gN* *v_gN* | |
| 112 gN Like |gn| but searches backward, like with `N`. | |
| 113 | |
| 7 | 114 *<LeftMouse>* |
| 115 <LeftMouse> Set the current cursor position. If Visual mode is | |
| 116 active it is stopped. Only when 'mouse' option is | |
| 117 contains 'n' or 'a'. If the position is within 'so' | |
| 118 lines from the last line on the screen the text is | |
| 119 scrolled up. If the position is within 'so' lines from | |
| 120 the first line on the screen the text is scrolled | |
| 121 down. | |
| 122 | |
| 123 *<RightMouse>* | |
| 124 <RightMouse> Start Visual mode if it is not active. The text from | |
| 125 the cursor position to the position of the click is | |
| 126 highlighted. If Visual mode was already active move | |
| 127 the start or end of the highlighted text, which ever | |
| 128 is closest, to the position of the click. Only when | |
| 129 'mouse' option contains 'n' or 'a'. | |
| 130 | |
| 131 Note: when 'mousemodel' is set to "popup", | |
| 132 <S-LeftMouse> has to be used instead of <RightMouse>. | |
| 133 | |
| 134 *<LeftRelease>* | |
| 135 <LeftRelease> This works like a <LeftMouse>, if it is not at | |
| 136 the same position as <LeftMouse>. In an older version | |
| 137 of xterm you won't see the selected area until the | |
| 138 button is released, unless there is access to the | |
| 139 display where the xterm is running (via the DISPLAY | |
| 140 environment variable or the -display argument). Only | |
| 141 when 'mouse' option contains 'n' or 'a'. | |
| 142 | |
| 143 If Visual mode is not active and the "v", "V" or CTRL-V is preceded with a | |
| 144 count, the size of the previously highlighted area is used for a start. You | |
| 145 can then move the end of the highlighted area and give an operator. The type | |
| 146 of the old area is used (character, line or blockwise). | |
| 147 - Linewise Visual mode: The number of lines is multiplied with the count. | |
| 148 - Blockwise Visual mode: The number of lines and columns is multiplied with | |
| 149 the count. | |
| 150 - Normal Visual mode within one line: The number of characters is multiplied | |
| 151 with the count. | |
| 152 - Normal Visual mode with several lines: The number of lines is multiplied | |
| 153 with the count, in the last line the same number of characters is used as | |
| 154 in the last line in the previously highlighted area. | |
| 155 The start of the text is the Cursor position. If the "$" command was used as | |
| 156 one of the last commands to extend the highlighted text, the area will be | |
| 157 extended to the rightmost column of the longest line. | |
| 158 | |
| 159 If you want to highlight exactly the same area as the last time, you can use | |
| 160 "gv" |gv| |v_gv|. | |
| 161 | |
| 42 | 162 *v_<Esc>* |
| 163 <Esc> In Visual mode: Stop Visual mode. | |
| 164 | |
| 7 | 165 *v_CTRL-C* |
| 166 CTRL-C In Visual mode: Stop Visual mode. When insert mode is | |
| 167 pending (the mode message shows | |
| 168 "-- (insert) VISUAL --"), it is also stopped. | |
| 169 | |
| 170 ============================================================================== | |
| 171 3. Changing the Visual area *visual-change* | |
| 172 | |
| 173 *v_o* | |
| 174 o Go to Other end of highlighted text: The current | |
| 175 cursor position becomes the start of the highlighted | |
| 176 text and the cursor is moved to the other end of the | |
| 177 highlighted text. The highlighted area remains the | |
| 178 same. | |
| 179 | |
| 180 *v_O* | |
| 181 O Go to Other end of highlighted text. This is like | |
| 182 "o", but in Visual block mode the cursor moves to the | |
| 183 other corner in the same line. When the corner is at | |
| 184 a character that occupies more than one position on | |
| 185 the screen (e.g., a <Tab>), the highlighted text may | |
| 186 change. | |
| 187 | |
| 188 *v_$* | |
| 189 When the "$" command is used with blockwise Visual mode, the right end of the | |
| 190 highlighted text will be determined by the longest highlighted line. This | |
| 191 stops when a motion command is used that does not move straight up or down. | |
| 192 | |
| 193 For moving the end of the block many commands can be used, but you cannot | |
| 194 use Ex commands, commands that make changes or abandon the file. Commands | |
| 1121 | 195 (starting with) ".", "&", CTRL-^, "Z", CTRL-], CTRL-T, CTRL-R, CTRL-I |
| 7 | 196 and CTRL-O cause a beep and Visual mode continues. |
| 197 | |
| 198 When switching to another window on the same buffer, the cursor position in | |
| 199 that window is adjusted, so that the same Visual area is still selected. This | |
| 200 is especially useful to view the start of the Visual area in one window, and | |
| 201 the end in another. You can then use <RightMouse> (or <S-LeftMouse> when | |
| 42 | 202 'mousemodel' is "popup") to drag either end of the Visual area. |
| 7 | 203 |
| 204 ============================================================================== | |
| 205 4. Operating on the Visual area *visual-operators* | |
| 206 | |
| 207 The operators that can be used are: | |
| 208 ~ switch case |v_~| | |
| 209 d delete |v_d| | |
| 210 c change (4) |v_c| | |
| 211 y yank |v_y| | |
| 212 > shift right (4) |v_>| | |
| 213 < shift left (4) |v_<| | |
| 214 ! filter through external command (1) |v_!| | |
| 215 = filter through 'equalprg' option command (1) |v_=| | |
| 216 gq format lines to 'textwidth' length (1) |v_gq| | |
| 217 | |
| 218 The objects that can be used are: | |
| 219 aw a word (with white space) |v_aw| | |
| 220 iw inner word |v_iw| | |
| 221 aW a WORD (with white space) |v_aW| | |
| 222 iW inner WORD |v_iW| | |
| 223 as a sentence (with white space) |v_as| | |
| 224 is inner sentence |v_is| | |
| 225 ap a paragraph (with white space) |v_ap| | |
| 226 ip inner paragraph |v_ip| | |
| 227 ab a () block (with parenthesis) |v_ab| | |
| 228 ib inner () block |v_ib| | |
| 229 aB a {} block (with braces) |v_aB| | |
| 230 iB inner {} block |v_iB| | |
|
2098
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
231 at a <tag> </tag> block (with tags) |v_at| |
|
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
232 it inner <tag> </tag> block |v_it| |
| 7 | 233 a< a <> block (with <>) |v_a<| |
| 234 i< inner <> block |v_i<| | |
| 235 a[ a [] block (with []) |v_a[| | |
| 236 i[ inner [] block |v_i[| | |
|
2098
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
237 a" a double quoted string (with quotes) |v_aquote| |
|
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
238 i" inner double quoted string |v_iquote| |
|
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
239 a' a single quoted string (with quotes) |v_a'| |
|
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
240 i' inner simple quoted string |v_i'| |
|
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
241 a` a string in backticks (with backticks) |v_a`| |
|
3259c3923c1e
Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
2033
diff
changeset
|
242 i` inner string in backticks |v_i`| |
| 7 | 243 |
| 244 Additionally the following commands can be used: | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
245 : start Ex command for highlighted lines (1) |v_:| |
| 7 | 246 r change (4) |v_r| |
| 247 s change |v_s| | |
| 248 C change (2)(4) |v_C| | |
| 249 S change (2) |v_S| | |
| 250 R change (2) |v_R| | |
| 251 x delete |v_x| | |
| 252 D delete (3) |v_D| | |
| 253 X delete (2) |v_X| | |
| 254 Y yank (2) |v_Y| | |
| 255 p put |v_p| | |
| 256 J join (1) |v_J| | |
| 257 U make uppercase |v_U| | |
| 258 u make lowercase |v_u| | |
| 259 ^] find tag |v_CTRL-]| | |
| 260 I block insert |v_b_I| | |
| 261 A block append |v_b_A| | |
| 262 | |
| 263 (1): Always whole lines, see |:visual_example|. | |
| 264 (2): Whole lines when not using CTRL-V. | |
| 265 (3): Whole lines when not using CTRL-V, delete until the end of the line when | |
| 266 using CTRL-V. | |
| 267 (4): When using CTRL-V operates on the block only. | |
| 268 | |
| 269 Note that the ":vmap" command can be used to specifically map keys in Visual | |
| 270 mode. For example, if you would like the "/" command not to extend the Visual | |
| 271 area, but instead take the highlighted text and search for that: > | |
| 272 :vmap / y/<C-R>"<CR> | |
| 273 (In the <> notation |<>|, when typing it you should type it literally; you | |
| 274 need to remove the 'B' and '<' flags from 'cpoptions'.) | |
| 275 | |
| 276 If you want to give a register name using the """ command, do this just before | |
| 277 typing the operator character: "v{move-around}"xd". | |
| 278 | |
| 279 If you want to give a count to the command, do this just before typing the | |
| 280 operator character: "v{move-around}3>" (move lines 3 indents to the right). | |
| 281 | |
| 282 *{move-around}* | |
| 283 The {move-around} is any sequence of movement commands. Note the difference | |
| 284 with {motion}, which is only ONE movement command. | |
| 285 | |
| 638 | 286 Another way to operate on the Visual area is using the |/\%V| item in a |
| 287 pattern. For example, to replace all '(' in the Visual area with '#': > | |
| 288 | |
| 3682 | 289 :'<,'>s/\%V(/#/g |
| 290 | |
| 291 Note that the "'<,'>" will appear automatically when you press ":" in Visual | |
| 292 mode. | |
| 638 | 293 |
| 7 | 294 ============================================================================== |
| 295 5. Blockwise operators *blockwise-operators* | |
| 296 | |
| 297 {not available when compiled without the |+visualextra| feature} | |
| 298 | |
| 299 Reminder: Use 'virtualedit' to be able to select blocks that start or end | |
| 300 after the end of a line or halfway a tab. | |
| 301 | |
| 302 Visual-block Insert *v_b_I* | |
| 303 With a blockwise selection, I{string}<ESC> will insert {string} at the start | |
| 304 of block on every line of the block, provided that the line extends into the | |
| 305 block. Thus lines that are short will remain unmodified. TABs are split to | |
| 306 retain visual columns. | |
| 307 See |v_b_I_example|. | |
| 308 | |
| 309 Visual-block Append *v_b_A* | |
| 310 With a blockwise selection, A{string}<ESC> will append {string} to the end of | |
| 236 | 311 block on every line of the block. There is some differing behavior where the |
| 7 | 312 block RHS is not straight, due to different line lengths: |
| 313 | |
| 314 1. Block was created with <C-v>$ | |
| 315 In this case the string is appended to the end of each line. | |
| 316 2. Block was created with <C-v>{move-around} | |
| 317 In this case the string is appended to the end of the block on each line, | |
| 318 and whitespace is inserted to pad to the end-of-block column. | |
| 319 See |v_b_A_example|. | |
| 320 Note: "I" and "A" behave differently for lines that don't extend into the | |
| 321 selected block. This was done intentionally, so that you can do it the way | |
| 322 you want. | |
| 323 | |
| 324 Visual-block change *v_b_c* | |
| 325 All selected text in the block will be replaced by the same text string. When | |
| 326 using "c" the selected text is deleted and Insert mode started. You can then | |
| 327 enter text (without a line break). When you hit <Esc>, the same string is | |
| 328 inserted in all previously selected lines. | |
| 329 | |
| 330 Visual-block Change *v_b_C* | |
| 331 Like using "c", but the selection is extended until the end of the line for | |
| 332 all lines. | |
| 333 | |
| 334 *v_b_<* | |
| 335 Visual-block Shift *v_b_>* | |
| 236 | 336 The block is shifted by 'shiftwidth'. The RHS of the block is irrelevant. The |
| 7 | 337 LHS of the block determines the point from which to apply a right shift, and |
| 236 | 338 padding includes TABs optimally according to 'ts' and 'et'. The LHS of the |
| 7 | 339 block determines the point upto which to shift left. |
| 340 See |v_b_>_example|. | |
| 341 See |v_b_<_example|. | |
| 342 | |
| 343 Visual-block Replace *v_b_r* | |
| 344 Every screen char in the highlighted region is replaced with the same char, ie | |
| 345 TABs are split and the virtual whitespace is replaced, maintaining screen | |
| 346 layout. | |
| 347 See |v_b_r_example|. | |
| 348 | |
| 349 | |
| 350 ============================================================================== | |
| 351 6. Repeating *visual-repeat* | |
| 352 | |
| 353 When repeating a Visual mode operator, the operator will be applied to the | |
| 354 same amount of text as the last time: | |
| 355 - Linewise Visual mode: The same number of lines. | |
| 356 - Blockwise Visual mode: The same number of lines and columns. | |
| 357 - Normal Visual mode within one line: The same number of characters. | |
| 358 - Normal Visual mode with several lines: The same number of lines, in the | |
| 359 last line the same number of characters as in the last line the last time. | |
| 360 The start of the text is the Cursor position. If the "$" command was used as | |
| 361 one of the last commands to extend the highlighted text, the repeating will | |
| 362 be applied up to the rightmost column of the longest line. | |
| 363 | |
| 364 | |
| 365 ============================================================================== | |
| 366 7. Examples *visual-examples* | |
| 367 | |
| 368 *:visual_example* | |
| 369 Currently the ":" command works on whole lines only. When you select part of | |
| 370 a line, doing something like ":!date" will replace the whole line. If you | |
| 371 want only part of the line to be replaced you will have to make a mapping for | |
| 372 it. In a future release ":" may work on partial lines. | |
| 373 | |
| 374 Here is an example, to replace the selected text with the output of "date": > | |
| 375 :vmap _a <Esc>`>a<CR><Esc>`<i<CR><Esc>!!date<CR>kJJ | |
| 376 | |
| 377 (In the <> notation |<>|, when typing it you should type it literally; you | |
| 378 need to remove the 'B' and '<' flags from 'cpoptions') | |
| 379 | |
| 380 What this does is: | |
| 381 <Esc> stop Visual mode | |
| 382 `> go to the end of the Visual area | |
| 383 a<CR><Esc> break the line after the Visual area | |
| 384 `< jump to the start of the Visual area | |
| 385 i<CR><Esc> break the line before the Visual area | |
| 386 !!date<CR> filter the Visual text through date | |
| 387 kJJ Join the lines back together | |
| 388 | |
| 389 *visual-search* | |
| 390 Here is an idea for a mapping that makes it possible to do a search for the | |
| 391 selected text: > | |
| 392 :vmap X y/<C-R>"<CR> | |
| 393 | |
| 394 (In the <> notation |<>|, when typing it you should type it literally; you | |
| 395 need to remove the 'B' and '<' flags from 'cpoptions') | |
| 396 | |
| 397 Note that special characters (like '.' and '*') will cause problems. | |
| 398 | |
| 399 Visual-block Examples *blockwise-examples* | |
| 400 With the following text, I will indicate the commands to produce the block and | |
| 236 | 401 the results below. In all cases, the cursor begins on the 'a' in the first |
| 42 | 402 line of the test text. |
| 7 | 403 The following modeline settings are assumed ":ts=8:sw=4:". |
| 404 | |
| 405 It will be helpful to | |
| 406 :set hls | |
| 407 /<TAB> | |
| 236 | 408 where <TAB> is a real TAB. This helps visualise the operations. |
| 7 | 409 |
| 410 The test text is: | |
| 411 | |
| 412 abcdefghijklmnopqrstuvwxyz | |
| 413 abc defghijklmnopqrstuvwxyz | |
| 414 abcdef ghi jklmnopqrstuvwxyz | |
| 415 abcdefghijklmnopqrstuvwxyz | |
| 416 | |
| 417 1. fo<C-v>3jISTRING<ESC> *v_b_I_example* | |
| 418 | |
| 419 abcdefghijklmnSTRINGopqrstuvwxyz | |
| 420 abc STRING defghijklmnopqrstuvwxyz | |
| 421 abcdef ghi STRING jklmnopqrstuvwxyz | |
| 422 abcdefghijklmnSTRINGopqrstuvwxyz | |
| 423 | |
| 424 2. fo<C-v>3j$ASTRING<ESC> *v_b_A_example* | |
| 425 | |
| 426 abcdefghijklmnopqrstuvwxyzSTRING | |
| 427 abc defghijklmnopqrstuvwxyzSTRING | |
| 428 abcdef ghi jklmnopqrstuvwxyzSTRING | |
| 429 abcdefghijklmnopqrstuvwxyzSTRING | |
| 430 | |
| 431 3. fo<C-v>3j3l<.. *v_b_<_example* | |
| 432 | |
| 433 abcdefghijklmnopqrstuvwxyz | |
| 434 abc defghijklmnopqrstuvwxyz | |
| 435 abcdef ghi jklmnopqrstuvwxyz | |
| 436 abcdefghijklmnopqrstuvwxyz | |
| 437 | |
| 438 4. fo<C-v>3j>.. *v_b_>_example* | |
| 439 | |
| 440 abcdefghijklmn opqrstuvwxyz | |
| 441 abc defghijklmnopqrstuvwxyz | |
| 442 abcdef ghi jklmnopqrstuvwxyz | |
| 443 abcdefghijklmn opqrstuvwxyz | |
| 444 | |
| 445 5. fo<C-v>5l3jrX *v_b_r_example* | |
| 446 | |
| 447 abcdefghijklmnXXXXXXuvwxyz | |
| 448 abc XXXXXXhijklmnopqrstuvwxyz | |
| 449 abcdef ghi XXXXXX jklmnopqrstuvwxyz | |
| 450 abcdefghijklmnXXXXXXuvwxyz | |
| 451 | |
| 452 ============================================================================== | |
| 453 8. Select mode *Select* *Select-mode* | |
| 454 | |
| 455 Select mode looks like Visual mode, but the commands accepted are quite | |
| 456 different. This resembles the selection mode in Microsoft Windows. | |
| 457 When the 'showmode' option is set, "-- SELECT --" is shown in the last line. | |
| 458 | |
| 459 Entering Select mode: | |
| 460 - Using the mouse to select an area, and 'selectmode' contains "mouse". | |
| 461 'mouse' must also contain a flag for the current mode. | |
| 462 - Using a non-printable movement command, with the Shift key pressed, and | |
| 463 'selectmode' contains "key". For example: <S-Left> and <S-End>. 'keymodel' | |
| 464 must also contain "startsel". | |
| 465 - Using "v", "V" or CTRL-V command, and 'selectmode' contains "cmd". | |
| 466 - Using "gh", "gH" or "g_CTRL-H" command in Normal mode. | |
| 467 - From Visual mode, press CTRL-G. *v_CTRL-G* | |
| 468 | |
| 469 Commands in Select mode: | |
| 470 - Printable characters, <NL> and <CR> cause the selection to be deleted, and | |
| 471 Vim enters Insert mode. The typed character is inserted. | |
| 472 - Non-printable movement commands, with the Shift key pressed, extend the | |
| 473 selection. 'keymodel' must include "startsel". | |
| 474 - Non-printable movement commands, with the Shift key NOT pressed, stop Select | |
| 475 mode. 'keymodel' must include "stopsel". | |
| 476 - ESC stops Select mode. | |
| 477 - CTRL-O switches to Visual mode for the duration of one command. *v_CTRL-O* | |
| 478 - CTRL-G switches to Visual mode. | |
| 479 | |
| 480 Otherwise, typed characters are handled as in Visual mode. | |
| 481 | |
| 482 When using an operator in Select mode, and the selection is linewise, the | |
| 483 selected lines are operated upon, but like in characterwise selection. For | |
| 484 example, when a whole line is deleted, it can later be pasted halfway a line. | |
| 485 | |
| 486 | |
| 487 Mappings and menus in Select mode. *Select-mode-mapping* | |
| 488 | |
| 788 | 489 When mappings and menus are defined with the |:vmap| or |:vmenu| command they |
| 490 work both in Visual mode and in Select mode. When these are used in Select | |
| 491 mode Vim automatically switches to Visual mode, so that the same behavior as | |
| 492 in Visual mode is effective. If you don't want this use |:xmap| or |:smap|. | |
| 7 | 493 |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
494 Users will expect printable characters to replace the selected area. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
495 Therefore avoid mapping printable characters in Select mode. Or use |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
496 |:sunmap| after |:map| and |:vmap| to remove it for Select mode. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
497 |
| 7 | 498 After the mapping or menu finishes, the selection is enabled again and Select |
| 499 mode entered, unless the selected area was deleted, another buffer became | |
| 500 the current one or the window layout was changed. | |
| 501 | |
| 502 When a character was typed that causes the selection to be deleted and Insert | |
| 503 mode started, Insert mode mappings are applied to this character. This may | |
| 504 cause some confusion, because it means Insert mode mappings apply to a | |
| 505 character typed in Select mode. Language mappings apply as well. | |
| 506 | |
| 507 *gV* *v_gV* | |
| 508 gV Avoid the automatic reselection of the Visual area | |
| 509 after a Select mode mapping or menu has finished. | |
| 510 Put this just before the end of the mapping or menu. | |
| 511 At least it should be after any operations on the | |
| 512 selection. | |
| 513 | |
| 514 *gh* | |
| 515 gh Start Select mode, characterwise. This is like "v", | |
| 516 but starts Select mode instead of Visual mode. | |
| 517 Mnemonic: "get highlighted". | |
| 518 | |
| 519 *gH* | |
| 520 gH Start Select mode, linewise. This is like "V", | |
| 521 but starts Select mode instead of Visual mode. | |
| 522 Mnemonic: "get Highlighted". | |
| 523 | |
| 524 *g_CTRL-H* | |
| 525 g CTRL-H Start Select mode, blockwise. This is like CTRL-V, | |
| 526 but starts Select mode instead of Visual mode. | |
| 527 Mnemonic: "get Highlighted". | |
| 528 | |
| 529 vim:tw=78:ts=8:ft=help:norl: |