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