Skip to content

Commit

Permalink
Editing: MultiEdit: second Ctrl+Click to undo portion of MultiSelection
Browse files Browse the repository at this point in the history
  • Loading branch information
pryrt committed Jan 3, 2024
1 parent 1b1990e commit 1928f1a
Showing 1 changed file with 5 additions and 7 deletions.
12 changes: 5 additions & 7 deletions content/docs/editing.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,20 +59,18 @@ The Column Editor dialog, accessed via **Edit > Column Editor**, allows you to i

Multi-Editing mode (available via mouse usage only) allows you to make multiple carets by using `Ctrl+Click` for each additional caret. This allows performing the same editing actions (typing, copy/cut/paste/delete, arrowing through the text) in multiple locations, even if they aren't lined up in a nice column, or even if there are lines between the carets that you don't want to affect. You may place as many additional carets as you want.

In addition to placing additional carets, you may also make multiple selections. After making an initial selection, do a `Ctrl+LeftClick+Drag` operation to place a second selection in another location. You may create as many such selections as you'd like. A primary use for this type of selection might be so that you can copy several selections with one command, or to replace multiple selections with the same content if you begin typing or do a paste.
In addition to placing additional carets, you may also make multiple selections. After making an initial selection, do a `Ctrl+Click+Drag` operation to place a second selection in another location. You may create as many such selections as you'd like. A primary use for this type of selection might be so that you can copy several selections with one command, or to replace multiple selections with the same content if you begin typing or do a paste.

Multi-Editing mode is only available when stream selection(s) are active; it doesn't work in conjunction with column-block selection. Unlike stream selections, where with Multi-editing you can define two or more selections simultaneously, with column mode there can be only one active selection at a time.
Starting in v8.6.1, if you `Ctrl+Click` at a previous multi-caret location, or `Ctrl+Click` within a previous multi-selection region, that caret or selection region will be removed, while leaving other portions of your multi-selection still active. (This effectively allows you to "undo" a _portion_ of the multi-selection without having to redo everything, and is useful in complex multi-selections when you accidentally `Ctrl+Clicked` in the wrong place or changed your mind.)

Whether or not you can use Multi-Editing mode is determined by the [**Settings > Preferences > Editing > ☑ Enable Multi-Editing (Ctrl+Mouse click/selection)**](../preferences/#editing) checkbox: with it checkmarked, `Ctrl+Click` will add caret locations; with it not checkmarked, Multi-Editing is disabled.
Multi-Editing mode is only available when stream selection(s) are active; it doesn't work in conjunction with column-block selection. Unlike stream selections, where with Multi-editing you can define two or more selections simultaneously, with column mode there can be only one active selection at a time.

Animation showing enabling Multi-Editing, and example usage of making multiple carets:
Before v8.6, whether or not you can use Multi-Editing mode was determined by the [**Settings > Preferences > Editing > ☑ Enable Multi-Editing (Ctrl+Mouse click/selection)**](../preferences/#editing) checkbox: with it checkmarked, `Ctrl+Click` will add caret locations; with it not checkmarked, Multi-Editing is disabled. Starting in v8.6, Multi-Editing is always on, and that option has been removed.

![](../images/multiEdit.gif)
Starting in v8.6, Multi-Edit became the default, and was significantly enhanced. The **Multi-Editing HowTo** (below) gives a tutorial in how to use this improved feature, including the new [**Edit** menu](#edit-menu) **...Multi-Select...** commands.

### Multi-Editing HowTo

Starting in v8.6, Multi-Edit became the default, and was significantly enhanced. This section gives a tutorial in how to use this improved feature.

The animation below is the demo of the feature that was published on the [v8.6 release announce](https://notepad-plus-plus.org/news/v86-20thyearanniversary/):

![multiedit](https://github.com/notepad-plus-plus/notepad-plus-plus/assets/90293/79b59d65-6862-4e5d-b2c2-1d19d0f2f551)
Expand Down

0 comments on commit 1928f1a

Please sign in to comment.