Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add clarification for overtype mode #7968

Merged
merged 1 commit into from
Jan 26, 2025
Merged

Add clarification for overtype mode #7968

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/editor/codebasics.md
View file
Open in desktop
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
View file
Open in desktop
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