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

Jump to bottom

Add docs for windowing behavior #251

Merged
merged 1 commit into from
Feb 23, 2021
Merged

Add docs for windowing behavior #251

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
23 changes: 23 additions & 0 deletions TerminalDocs/customize-settings/startup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,29 @@ This defines whether the terminal will launch as maximized, full screen, or in a

___

## Windowing Behavior

This setting controls how new terminal instances attach to existing windows. This propoerty is only used if the `--window,-w window` commandline argument is not provided. This setting accepts the following possible values:

* `useNew`: Create a new window, always. This is how the Terminal always behaved prior to version 1.7.
* `useExisting`: Create new tabs in the most recently used window on this desktop. If there's not an existing window on this virtual desktop, then create a new Terminal window.
* `useAnyExisting`: Create new tabs in the most recently used window, regardless of which virtual desktop the window is on.

**Property name:** `windowingBehavior`

**Necessity:** Optional

**Accepts:** `"useNew"`, `"useExisting"`, `"useAnyExisting"`

**Default value:** `"useNew"`

> [!IMPORTANT]
> This setting is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview), version 1.7+.

<br />

___

## Launch size

### Columns on first launch
Expand Down