Skip to content

Commit

Permalink
Merge pull request #7968 from microsoft/overtype
Browse files Browse the repository at this point in the history
Add clarification for overtype mode
  • Loading branch information
ntrogh authored Jan 26, 2025
2 parents c1d0ce2 + aa089a7 commit 592aec4
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 5 deletions.
6 changes: 4 additions & 2 deletions docs/editor/codebasics.md
Original file line number Diff line number Diff line change
Expand Up @@ -423,13 +423,15 @@ Then choose an encoding.

## Overtype mode

VS Code supports *overtype* mode, which lets you overwrite existing characters instead of inserting characters at the cursor position. By default, overtype mode is off.
Prior to release 1.96, VS Code only supported *insert* mode, where characters are inserted at the cursor position, unless you installed the Vim [keymap extension](/docs/getstarted/keybindings.md#keymap-extensions).

As of release 1.96, VS Code supports *overtype* mode, which lets you overwrite existing characters instead of inserting characters at the cursor position. By default, overtype mode is off.

To switch between insert and overtype mode, run the **Toggle Overtype/Insert Mode** command in the Command Palette or press (`kb(editor.action.toggleOvertypeInsertMode)`). When you're in overtype mode, a Status Bar indicator shows `OVR`.

You can change the cursor style for overtype mode by configuring the `setting(editor.overtypeCursorStyle)` setting.

The `setting(editor.overtypeOnPaste)` setting enables you to use overtype for pasting text. You need to be in overtype mode for this setting to take effect.
Use the `setting(editor.overtypeOnPaste)` setting to overwrite text when pasting. You need to be in overtype mode for this setting to take effect.

## Compare files

Expand Down
6 changes: 3 additions & 3 deletions release-notes/v1_96.md
Original file line number Diff line number Diff line change
Expand Up @@ -276,13 +276,13 @@ The Find control now can persist the search history across sessions and restores

### Overtype mode

On popular request, we added overtype mode to overwrite text in the editor instead of inserting it when typing. A useful scenario for this is when editing Markdown tables, where you want to keep the table cell boundaries nicely aligned.
Did you know that VS Code didn't support overwriting text in the editor, unless you installed the Vim keymap? On popular request, we now added overtype mode to overwrite text in the editor instead of inserting it when typing. A useful scenario for this is when editing Markdown tables, where you want to keep the table cell boundaries nicely aligned.

This mode can be toggled with the command **View: Toggle Overtype/Insert Mode**. When you're in overtype mode, the Status Bar shows an `OVR` indicator. In addition, there is a setting `setting(editor.overtypeOnPaste)`, which determines whether pasting in overtype mode should overwrite or insert. The default behavior is to insert pasted text.
This mode can be toggled with the command **View: Toggle Overtype/Insert Mode** or by using the `kbstyle(Insert)` key on your keyboard. When you're in overtype mode, the Status Bar shows an `OVR` indicator.

<video src="images/1_96/overtype.mp4" title="Overtype mode" autoplay loop controls muted></video>

It is possible to change the cursor style while in overtype mode by using the setting `setting(editor.overtypeCursorStyle)`.
It is possible to change the cursor style while in overtype mode by using the setting `setting(editor.overtypeCursorStyle)`. In addition, there is a setting `setting(editor.overtypeOnPaste)`, which determines whether pasting in overtype mode should overwrite or insert. The default behavior is to insert pasted text.

## Source Control

Expand Down

0 comments on commit 592aec4

Please sign in to comment.