Azioni personalizzate e tasti di scelta rapida in Terminale Windows

In Terminale Windows è possibile creare azioni personalizzate per controllare l'interazione con il terminale. Queste azioni verranno aggiunte automaticamente al riquadro comandi.

Formati azione

Le azioni possono essere strutturate nei formati seguenti:

Comandi senza argomenti

{ "command": "commandName", "id": "User.MyCommand" }

Ad esempio, questa impostazione predefinita usa il tasto di scelta rapida ALT+F4 per chiudere la finestra del terminale:

{ "command": "closeWindow", "id": "User.MyCloseWindow" }

Comandi con argomenti

{ "command": { "action": "commandName", "argument": "value" }, "id": "User.MyCommand" }

Ad esempio, questa impostazione predefinita usa il tasto di scelta rapida CTRL+MAIUSC+1 per aprire una nuova scheda nel terminale in base a qualsiasi profilo sia elencato per primo nel menu a discesa (in genere verrà aperto il profilo di PowerShell):

{ "command": { "action": "newTab", "index": 0 }, "id": "User.MyNewTabAction" }

Comandi con argomenti della riga di comando

{ "command": { "action": "wt", "commandline": "value" }, "keys": "modifiers+key" }

Ad esempio, questa impostazione predefinita usa il tasto di scelta rapida CTRL+MAIUSC+O da usare wt per aprire una nuova scheda di PowerShell con riquadri aggiuntivi per prompt dei comandi e Ubuntu:

{
  "command": 
  {
    "action": "wt",
    "commandline": "new-tab pwsh.exe ; split-pane -p \"Command Prompt\" -d C:\\ ; split-pane -p \"Ubuntu\" -H"
  },
  "keys": "ctrl+shift+o"
}

Proprietà delle azioni

Le azioni vengono archiviate nella actions matrice e possono essere costruite usando le proprietà seguenti.

Comando

Comando eseguito quando vengono premuti i tasti associati.

Nome della proprietà: command

Necessità: obbligatoria

Accetta: stringa

Azione

Aggiunge funzionalità aggiuntive a determinati comandi.

Nome della proprietà: action

Necessità: facoltativa

Accetta: stringa

Nome

In questo modo viene impostato il nome che verrà visualizzato nel riquadro comandi. Se non ne viene specificato uno, il terminale tenterà di generare automaticamente un nome.

Nome della proprietà: name

Necessità: facoltativa

Accetta: stringa

Icona

In questo modo viene impostata l'icona visualizzata all'interno del riquadro comandi.

Nome della proprietà: icon

Necessità: facoltativa

Accetta: percorso del file come stringa o emoji

ID

In questo modo viene impostato l'ID di questa azione. Se non viene specificato, il terminale genererà un ID per questa azione. L'ID viene usato per fare riferimento a questa azione durante la creazione di tasti di scelta rapida.

Nome della proprietà: id

Necessità: facoltativa

Accetta: String

Tasti di scelta rapida

Le azioni possono essere assegnate a tasti di scelta rapida facendo riferimento a essi con il relativo ID univoco. Ad esempio, ecco una possibile keybindings matrice che assegna ALT+F4, CTRL+MAIUSC+1 e CTRL+MAIUSC+o alle azioni definite in precedenza. È possibile creare più voci di tasti per la stessa azione.

"keybindings": [
  { "keys": "alt+f4", "id": "User.MyCloseWindow" },
  { "keys": "ctrl+shift+1", "id": "User.MyNewTabAction" },
  { "keys": "ctrl+shift+o", "id": "User.MyCoolSetup"}
]

Proprietà di scelta rapida

I tasti di scelta rapida vengono archiviati nella keybindings matrice e vengono costruiti usando le proprietà seguenti.

Chiavi

Definisce le combinazioni di tasti usate per chiamare il comando. Con la proprietà keys è possibile associare più modificatori a un unico tasto. I tasti e i modificatori accettati sono elencati di seguito.

Se l'azione non dispone di tasti, verrà visualizzata nel riquadro comandi, ma non potrà essere richiamata con la tastiera.

Nome della proprietà: keys

Necessità: obbligatoria

Accetta: stringa o matrice[stringa]

ID

ID dell'azione da richiamare quando viene premuto questo tasto di scelta rapida.

Nome della proprietà: id

Necessità: obbligatoria

Accetta: stringa

Modificatori accettati

ctrl+, shift+, alt+win+

Tasti di modifica

Nota: = e plus sono equivalenti. Quest'ultimo non deve essere confuso con numpad_plus.

Comandi a livello di applicazione

Uscire

In questo modo vengono chiuse tutte le finestre del terminale aperte. Verrà visualizzata una finestra di dialogo di conferma nella finestra corrente per assicurarsi di chiudere tutte le finestre.

Nome del comando: quit

ID predefinito:

{ "command": "quit", "id": "Terminal.Quit" }

Chiudere la finestra

{ "command": "closeWindow", "id": "Terminal.CloseWindow" }

{ "keys": "alt+f4", "id": "Terminal.CloseWindow" }

Trova

Apre la finestra di dialogo di ricerca. Per altre informazioni sulla ricerca, vedi la pagina relativa alla ricerca.

Nome del comando: find

ID predefinito:

{ "command": "find", "id": "Terminal.FindText" }

Associazione predefinita:

{ "keys": "ctrl+shift+f", "id": "Terminal.FindText" }

Trovare la corrispondenza di ricerca successiva/precedente

In questo modo è possibile spostarsi tra le corrispondenze di ricerca.

Nome del comando: findMatch

ID predefiniti:

{ "command": { "action": "findMatch", "direction": "next" }, "id": "Terminal.FindNextMatch" },
{ "command": { "action": "findMatch", "direction": "prev" }, "id": "Terminal.FindPrevMatch" }

Parametri

Apri menu a discesa

Apre il menu a discesa.

Nome del comando: openNewTabDropdown

ID predefinito:

{ "command": "openNewTabDropdown", "id": "Terminal.OpenNewTabDropdown" }

Associazione predefinita:

{ "keys": "ctrl+shift+space", "id": "Terminal.OpenNewTabDropdown" }

Apri file di impostazioni

Verrà aperta l'interfaccia utente delle impostazioni, il file di impostazioni personalizzate (settings.json) o il file di impostazioni predefinite (defaults.json), a seconda del campo target. Senza il campo target, verrà aperto il file di impostazioni personalizzate.

Nome del comando: openSettings

ID predefiniti:

{ "command": { "action": "openSettings", "target": "settingsUI" }, "id": "Terminal.OpenSettingsUI" },
{ "command": { "action": "openSettings", "target": "settingsFile" }, "id": "Terminal.OpenSettingsFile" },
{ "command": { "action": "openSettings", "target": "defaultsFile" }, "keys": "Terminal.OpenDefaultSettingsFile" }

Associazioni predefinite:

{ "keys": "ctrl+,", "id": "Terminal.OpenSettingsUI" },
{ "keys": "ctrl+shift+,", "id": "Terminal.OpenSettingsFile" },
{ "keys": "ctrl+alt+,", "id": "Terminal.OpenDefaultSettingsFile" }

Parametri

Apri menu di sistema

Apre il menu di sistema nell'angolo superiore sinistro della finestra.

Nome del comando: openSystemMenu

ID predefinito:

{ "command": "openSystemMenu", "id": "Terminal.OpenSystemMenu" }

Associazione predefinita:

{ "keys": "alt+space", "id": "Terminal.OpenSystemMenu" }

Attiva/Disattiva schermo intero

Consente di passare dalla finestra a schermo intero a quella con dimensioni predefinite e viceversa.

Nome del comando: toggleFullscreen

ID predefinito

{ "command": "toggleFullscreen", "id": "Terminal.ToggleFullscreen" }

Associazioni predefinite:

{ "keys": "alt+enter", "id": "Terminal.ToggleFullscreen" },
{ "keys": "f11", "id": "Terminal.ToggleFullscreen" }

Attiva/disattiva la modalità dello stato attivo

In questo modo è possibile immettere la "modalità stato attivo", che nasconde le schede e la barra del titolo.

Nome del comando: toggleFocusMode

ID predefinito:

{ "command": "toggleFocusMode", "id": "Terminal.ToggleFocusMode" }

Attiva/disattiva la modalità sempre in primo piano

In questo modo è possibile attivare o disattivare lo stato "sempre in primo piano" della finestra. Quando si usa la modalità "sempre in primo piano", la finestra verrà visualizzata sopra tutte le altre finestre non in primo piano.

Nome del comando: toggleAlwaysOnTop

ID predefinito:

{ "command": "toggleAlwaysOnTop", "id": "Terminal.ToggleAlwaysOnTop" }

Invia input

Inviare input di testo arbitrario alla shell. Ad esempio, l'input "text\n" scriverà "text" seguito da una nuova riga nella shell.

È possibile usare sequenze di escape ANSI, ma i codici di escape come \x1b devono essere scritti come \u001b. Ad esempio, "\u001b[A" si comporta come se il pulsante freccia su fosse stato premuto.

Nome del comando: sendInput

Associazione predefinita:

Questo comando non è attualmente associato nelle impostazioni predefinite.

{ "command": { "action": "sendInput", "input": "\u001b[A" } }

Parametri

Comandi per la gestione delle schede

Chiudi scheda

In questo modo la scheda viene chiusa in corrispondenza di un determinato indice. Se non viene specificato alcun indice, usare l'indice della scheda con stato attivo.

Nome del comando: closeTab

Parametri

Chiudere tutte le altre schede

In questo modo tutte le schede vengono chiuse, ad eccezione di quella in corrispondenza di un indice. Se non viene specificato alcun indice, usare l'indice della scheda con stato attivo.

Nome del comando: closeOtherTabs

ID predefinito:

{ "command": "closeOtherTabs", "id": "Terminal.CloseOtherTabs" }

Parametri

Chiudere le schede dopo l'indice

Chiude le schede che seguono la scheda in corrispondenza di un indice. Se non viene specificato alcun indice, usare l'indice della scheda con stato attivo.

Nome del comando: closeTabsAfter

ID predefinito:

{ "command": "closeTabsAfter", "id": "Terminal.CloseTabsAfter" }

Parametri

Duplica scheda

Crea una copia del profilo e della directory della scheda correnti e la apre. Ciò non include variabili di ENV modificate/aggiunte.

Nome del comando: duplicateTab

ID predefinito:

{ "command": "duplicateTab", "id": "Terminal.DuplicateTab" }

Associazione predefinita:

{ "keys": "ctrl+shift+d", "id": "Terminal.DuplicateTab" }

Nuova scheda

Crea una nuova scheda. Se viene specificato senza argomenti, il profilo predefinito verrà aperto in una nuova scheda. Se non viene specificato un indice, verrà usata l'impostazione equivalente del profilo predefinito. Se l'indice non esegue il mapping a un profilo, le chiavi vengono passate direttamente al terminale o ignorate se non sono state usate chiavi per richiamare l'azione.

Nome del comando: newTab

ID predefiniti:

{ "command": "newTab", "id": "Terminal.OpenNewTab" },
{ "command": { "action": "newTab", "index": 0 }, "id": "Terminal.OpenNewTabProfile0" },
{ "command": { "action": "newTab", "index": 1 }, "id": "Terminal.OpenNewTabProfile1" },
{ "command": { "action": "newTab", "index": 2 }, "id": "Terminal.OpenNewTabProfile2" },
{ "command": { "action": "newTab", "index": 3 }, "id": "Terminal.OpenNewTabProfile3" },
{ "command": { "action": "newTab", "index": 4 }, "id": "Terminal.OpenNewTabProfile4" },
{ "command": { "action": "newTab", "index": 5 }, "id": "Terminal.OpenNewTabProfile5" },
{ "command": { "action": "newTab", "index": 6 }, "id": "Terminal.OpenNewTabProfile6" },
{ "command": { "action": "newTab", "index": 7 }, "id": "Terminal.OpenNewTabProfile7" },
{ "command": { "action": "newTab", "index": 8 }, "id": "Terminal.OpenNewTabProfile8" }

Associazioni predefinite:

{ "keys": "ctrl+shift+t", "id": "Terminal.OpenNewTab" },
{ "keys": "ctrl+shift+1", "id": "Terminal.OpenNewTabProfile0" },
{ "keys": "ctrl+shift+2", "id": "Terminal.OpenNewTabProfile1" },
{ "keys": "ctrl+shift+3", "id": "Terminal.OpenNewTabProfile2" },
{ "keys": "ctrl+shift+4", "id": "Terminal.OpenNewTabProfile3" },
{ "keys": "ctrl+shift+5", "id": "Terminal.OpenNewTabProfile4" },
{ "keys": "ctrl+shift+6", "id": "Terminal.OpenNewTabProfile5" },
{ "keys": "ctrl+shift+7", "id": "Terminal.OpenNewTabProfile6" },
{ "keys": "ctrl+shift+8", "id": "Terminal.OpenNewTabProfile7" },
{ "keys": "ctrl+shift+9", "id": "Terminal.OpenNewTabProfile8" }

Parametri

Apri scheda successiva

Apre la scheda a destra di quella corrente.

Nome del comando: nextTab

ID predefinito:

{ "command": "nextTab", "id": "Terminal.NextTab" }

Associazione predefinita:

{ "keys": "ctrl+tab", "id": "Terminal.NextTab" }

Parametri

Apri scheda precedente

Apre la scheda a sinistra di quella corrente.

Nome del comando: prevTab

ID predefinito:

{ "command": "prevTab", "id": "Terminal.PrevTab" }

Associazione predefinita:

{ "keys": "ctrl+shift+tab", "id": "Terminal.PrevTab" }

Parametri

Ricerca nelle schede

{"command": "tabSearch"}

Apri una scheda specifica

Apre una scheda specifica a seconda dell'indice.

Nome del comando: switchToTab

ID predefiniti:

{ "command": { "action": "switchToTab", "index": 0 }, "id": "Terminal.SwitchToTab0" },
{ "command": { "action": "switchToTab", "index": 1 }, "id": "Terminal.SwitchToTab1" },
{ "command": { "action": "switchToTab", "index": 2 }, "id": "Terminal.SwitchToTab2" },
{ "command": { "action": "switchToTab", "index": 3 }, "id": "Terminal.SwitchToTab3" },
{ "command": { "action": "switchToTab", "index": 4 }, "id": "Terminal.SwitchToTab4" },
{ "command": { "action": "switchToTab", "index": 5 }, "id": "Terminal.SwitchToTab5" },
{ "command": { "action": "switchToTab", "index": 6 }, "id": "Terminal.SwitchToTab6" },
{ "command": { "action": "switchToTab", "index": 7 }, "id": "Terminal.SwitchToTab7" }

Associazioni predefinite:

{ "keys": "ctrl+alt+1", "id": "Terminal.SwitchToTab0" },
{ "keys": "ctrl+alt+2", "id": "Terminal.SwitchToTab1" },
{ "keys": "ctrl+alt+3", "id": "Terminal.SwitchToTab2" },
{ "keys": "ctrl+alt+4", "id": "Terminal.SwitchToTab3" },
{ "keys": "ctrl+alt+5", "id": "Terminal.SwitchToTab4" },
{ "keys": "ctrl+alt+6", "id": "Terminal.SwitchToTab5" },
{ "keys": "ctrl+alt+7", "id": "Terminal.SwitchToTab6" },
{ "keys": "ctrl+alt+8", "id": "Terminal.SwitchToTab7" }

Parametri

Rinomina scheda

Questo comando può essere usato per rinominare una scheda in una stringa specifica.

Nome del comando: renameTab

Associazione predefinita:

Questo comando non è attualmente associato nelle impostazioni predefinite.

// Rename a tab to "Foo"
{ "command": { "action": "renameTab", "title": "Foo" } }

// Reset the tab's name
{ "command": { "action": "renameTab", "title": null } }

Parametri

Apri la casella di testo Rinomina scheda

Questo comando modifica il titolo della scheda in un campo di testo che consente di modificare il titolo per la scheda corrente. La cancellazione del campo di testo reimposta il titolo della scheda sul valore predefinito per l'istanza della shell corrente.

Nome del comando: openTabRenamer

ID predefinito:

{ "command": "openTabRenamer", "id": "Terminal.OpenTabRenamer" }

Modifica colore della scheda

Questo comando può essere usato per modificare il colore di una scheda impostando un valore specifico.

Nome del comando: setTabColor

Associazione predefinita:

Questo comando non è attualmente associato nelle impostazioni predefinite.

// Change the tab's color to a bright magenta
{ "command": { "action": "setTabColor", "color": "#ff00ff" } }

// Reset the tab's color
{ "command": { "action": "setTabColor", "color": null } }

Parametri

Apri selezione colori scheda

Questo comando può essere usato per aprire la selezione colori per la scheda attiva. La selezione colori può essere usata per impostare un colore per la scheda in fase di esecuzione.

Nome del comando: openTabColorPicker

ID predefinito:

{ "command": "openTabColorPicker", "id": "Terminal.OpenTabColorPicker" }

Sposta scheda

Questo comando sposta la scheda "indietro" e "avanti", che equivale a "sinistra" e "destra" nell'interfaccia utente da sinistra a destra.

Nome del comando: moveTab

ID predefiniti:

// Move tab backward (left in LTR)
{ "command": { "action": "moveTab", "direction": "backward" }, "id": "Terminal.MoveTabBackward" }

// Move tab forward (right in LTR)
{ "command": { "action": "moveTab", "direction": "forward" }, "id": "Terminal.MoveTabForward" }

Parametri

window è facoltativo e segue lo stesso formato dell'argomento --window-id della wt.exe riga di comando. Se viene omesso, la scheda verrà spostata all'interno della finestra corrente. Se specificato, può essere l'ID intero di una finestra o il nome di una finestra. Accetta anche i valori riservati seguenti:

• "new" o -1: eseguire sempre questo comando in una nuova finestra
• "last" o 0: eseguire sempre questo comando nella finestra usata più di recente

Se non esiste alcuna finestra con l'ID specificato window , verrà creata una nuova finestra con tale ID/nome.

Input di trasmissione

Questo comando attiva o disattiva la "modalità di trasmissione" per un riquadro. Quando la modalità di trasmissione è abilitata, tutti gli input inviati al riquadro verranno inviati a tutti i riquadri nella stessa scheda. Ciò è utile per inviare lo stesso input a più riquadri contemporaneamente.

Come per qualsiasi azione, è anche possibile richiamare "modalità broadcast" cercando "Attiva/disattiva input broadcast a tutti i riquadri" nel riquadro Comandi.

Nome del comando: toggleBroadcastInput

ID predefinito:

{ "command": "toggleBroadcastInput", "id": "Terminal.ToggleBroadcastInput" }

Apri menu di scelta rapida

Questo comando aprirà il menu di scelta rapida di "clic destro del mouse" per il riquadro attivo. Questo menu include azioni rilevanti per la gestione di riquadri, copia e incolla e altro ancora. Questa azione non richiede l'abilitazione dell'impostazione experimental.rightClickContextMenu.

Nome del comando: showContextMenu

ID predefinito:

{ "command": "showContextMenu", "id": "Terminal.ShowContextMenu" }

Apri finestra di dialogo Informazioni su

Questo comando aprirà la finestra di dialogo di informazioni sul terminale. Questa finestra di dialogo contiene informazioni sul terminale, tra cui il numero di versione, la licenza e altro ancora.

Nome del comando: openAbout

ID predefinito:

{ "command": "openAbout", "id": "Terminal.OpenAboutDialog" }

Cerca sul Web

Tenta di aprire una finestra del browser con una ricerca del testo selezionato. Questa operazione non esegue alcuna operazione se non è selezionato alcun testo. Se il parametro queryUrl non viene specificato, verrà invece usata l'impostazione searchWebDefaultQueryUrl. Se viene specificato il parametro queryUrl, nella stringa %s verrà sostituito dal testo selezionato.

Nome del comando: searchWeb

ID predefinito:

{ "command": { "action": "searchWeb" }, "id": "Terminal.SearchWeb" },

Parametri

Comandi di gestione delle finestre

New window

Viene creata una nuova scheda. Se viene specificato senza argomenti, il profilo predefinito verrà aperto in una nuova finestra (a prescindere dall'impostazione di windowingBehavior). Se non viene specificata un'azione, verrà usata l'impostazione equivalente del profilo predefinito.

Nome del comando: newWindow

ID predefinito:

{ "command": "newWindow", "id": "Terminal.OpenNewWindow" },

Associazione predefinita:

{ "keys": "ctrl+shift+n", "id": "Terminal.OpenNewWindow" },

Parametri

Rinomina finestra

Questo comando può essere usato per rinominare una finestra in una stringa specifica.

Nome del comando: renameWindow

Associazione predefinita:

Questo comando non è attualmente associato nelle impostazioni predefinite.

// Rename a window to "Foo"
{ "command": { "action": "renameWindow", "name": "Foo" } }

// Reset the window's name
{ "command": { "action": "renameWindow", "name": null } }

Parametri

Apri finestra di dialogo ridenominazione finestra

Questo comando cambia visualizza una finestra popup che consente di modificare il nome per la finestra corrente. La cancellazione del campo di testo reimposta il nome della finestra.

Nome del comando: openWindowRenamer

ID predefinito:

{ "command": "openWindowRenamer", "id": "Terminal.OpenWindowRenamer" }

Identifica finestra

Viene visualizzata una sovrimpressione nella finestra incentrata che visualizza il nome e l'indice della finestra.

Nome del comando: identifyWindow

ID predefinito:

{"command": "identifyWindow", "id": "Terminal.IdentifyWindow" },

Identifica finestre

Verrà visualizzata una sovrimpressione in tutte le finestre che visualizza il nome e l'indice di ogni finestra.

Nome del comando: identifyWindows

Associazione predefinita:

Questo comando non è attualmente associato nelle impostazioni predefinite.

{ "command": "identifyWindows" },

Comandi di gestione dei riquadri

Dividi un riquadro

Divide a metà il riquadro attivo e ne apre un altro. Se viene specificato senza argomenti, il profilo predefinito verrà aperto nel nuovo riquadro. Se non viene specificata un'azione, verrà usata l'impostazione equivalente del profilo predefinito.

Nome del comando: splitPane

ID predefiniti:

{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "auto" }, "id": "Terminal.DuplicatePaneAuto" },
{ "command": { "action": "splitPane", "split": "up" }, "id": "Terminal.SplitPaneUp" },
{ "command": { "action": "splitPane", "split": "down" }, "id": "Terminal.SplitPaneDown" },
{ "command": { "action": "splitPane", "split": "left" }, "id": "Terminal.SplitPaneLeft" },
{ "command": { "action": "splitPane", "split": "right" }, "id": "Terminal.SplitPaneRight" },
{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "down" }, "id": "Terminal.DuplicatePaneDown" },
{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "right" }, "id": "Terminal.DuplicatePaneRight" }

Associazioni predefinite:

{ "keys": "alt+shift+d", "id": "Terminal.DuplicatePaneAuto" },
{ "keys": "alt+shift+-", "id": "Terminal.DuplicatePaneDown" },
{ "keys": "alt+shift+plus", "id": "Terminal.DuplicatePaneRight" }

Parametri

Chiudi riquadro

Chiude il riquadro attivo. Se non sono presenti riquadri divisi, chiude la scheda corrente. Se è aperta una sola scheda, chiude la finestra.

Nome del comando: closePane

ID predefinito:

{ "command": "closePane", "id": "Terminal.ClosePane" }

Associazione predefinita:

{ "keys": "ctrl+shift+w", "id": "Terminal.ClosePane" }

Sposta stato attivo nel riquadro

Consente di spostare lo stato attivo in un altro riquadro a seconda della direzione. L'impostazione di direction su "previous" sposta lo stato attivo sul riquadro usato più di recente.

Nome del comando: moveFocus

ID predefiniti:

{ "command": { "action": "moveFocus", "direction": "down" }, "id": "Terminal.MoveFocusDown" },
{ "command": { "action": "moveFocus", "direction": "left" }, "id": "Terminal.MoveFocusLeft" },
{ "command": { "action": "moveFocus", "direction": "right" }, "id": "Terminal.MoveFocusRight" },
{ "command": { "action": "moveFocus", "direction": "up" }, "id": "Terminal.MoveFocusUp" },
{ "command": { "action": "moveFocus", "direction": "previous" }, "id": "Terminal.MoveFocusPrevious" }

Associazioni predefinite:

{ "keys": "alt+down", "id": "Terminal.MoveFocusDown" },
{ "keys": "alt+left", "id": "Terminal.MoveFocusLeft" },
{ "keys": "alt+right", "id": "Terminal.MoveFocusRight" },
{ "keys": "alt+up", "id": "Terminal.MoveFocusUp" },
{ "keys": "ctrl+alt+left", "id": "Terminal.MoveFocusPrevious" }

Parametri

Valori direction accettati

• up, down, left o right spostare lo stato attivo nella direzione specificata.
• first sposta lo stato attivo sul primo riquadro foglia dell'albero.
• previous sposta lo stato attivo sul riquadro usato più di recente prima del riquadro corrente.
• nextInOrder, previousInOrder sposta lo stato attivo sul riquadro successivo o precedente in ordine di creazione.
• parent sposta lo stato attivo per selezionare il riquadro padre del riquadro corrente. In questo modo l'utente può selezionare più riquadri contemporaneamente
• child sposta lo stato attivo sul primo riquadro figlio di questo riquadro.

Riquadro Sposta

Spostare il riquadro attualmente attivo in una scheda diversa nella finestra.

Nome del comando: movePane

ID predefiniti:

{ "command": { "action": "movePane", "index": 0 }, "id": "Terminal.MovePaneToTab0" },
{ "command": { "action": "movePane", "index": 1 }, "id": "Terminal.MovePaneToTab1" },
{ "command": { "action": "movePane", "index": 2 }, "id": "Terminal.MovePaneToTab2" },
{ "command": { "action": "movePane", "index": 3 }, "id": "Terminal.MovePaneToTab3" },
{ "command": { "action": "movePane", "index": 4 }, "id": "Terminal.MovePaneToTab4" },
{ "command": { "action": "movePane", "index": 5 }, "id": "Terminal.MovePaneToTab5" },
{ "command": { "action": "movePane", "index": 6 }, "id": "Terminal.MovePaneToTab6" },
{ "command": { "action": "movePane", "index": 7 }, "id": "Terminal.MovePaneToTab7" },
{ "command": { "action": "movePane", "index": 8 }, "id": "Terminal.MovePaneToTab8" }

Parametri

Scambia riquadri

Scambiare la posizione di due riquadri in una scheda. Questa operazione viene eseguita nel riquadro attivo e in un riquadro di destinazione, come designato dal parametro direction.

Nome del comando: swapPane

ID predefiniti:

{ "command": { "action": "swapPane", "direction": "down" }, "id": "Terminal.SwapPaneDown" },
{ "command": { "action": "swapPane", "direction": "left" }, "id": "Terminal.SwapPaneLeft" },
{ "command": { "action": "swapPane", "direction": "right" }, "id": "Terminal.SwapPaneRight" },
{ "command": { "action": "swapPane", "direction": "up" }, "id": "Terminal.SwapPaneUp" },
{ "command": { "action": "swapPane", "direction": "previous"}, "id": "Terminal.SwapPanePrevious" },
{ "command": { "action": "swapPane", "direction": "previousInOrder"}, "id": "Terminal.SwapPanePreviousInOrder" },
{ "command": { "action": "swapPane", "direction": "nextInOrder"}, "id": "Terminal.SwapPaneNextInOrder" },
{ "command": { "action": "swapPane", "direction": "first" }, "id": "Terminal.SwapPaneFirst" }

Parametri

Valori direction accettati (questi sono gli stessi valori del comando moveFocus)

• up, down, lefto right: scambia il riquadro attivo con quello nella direzione specificata.
• first: scambia il riquadro attivo con il primo riquadro foglia nell'albero.
• previous: scambia il riquadro attivo con il riquadro usato più di recente prima del riquadro corrente.
• nextInOrder, previousInOrder: scambia il riquadro attivo con il riquadro successivo o precedente in ordine di creazione.
• parent: non esegue operazioni.
• child: non esegue operazioni.

Ingrandisci un riquadro

{ "command": "togglePaneZoom", "id": "Terminal.TogglePaneZoom" }

Ridimensiona un riquadro

Modifica le dimensioni del riquadro attivo.

Nome del comando: resizePane

ID predefiniti:

{ "command": { "action": "resizePane", "direction": "down" }, "id": "Terminal.ResizePaneDown" },
{ "command": { "action": "resizePane", "direction": "left" }, "id": "Terminal.ResizePaneLeft" },
{ "command": { "action": "resizePane", "direction": "right" }, "id": "Terminal.ResizePaneRight" },
{ "command": { "action": "resizePane", "direction": "up" }, "id": "Terminal.ResizePaneUp" }

Associazioni predefinite:

{ "keys": "alt+shift+down", "id": "Terminal.ResizePaneDown" },
{ "keys": "alt+shift+left", "id": "Terminal.ResizePaneLeft" },
{ "keys": "alt+shift+right", "id": "Terminal.ResizePaneRight" },
{ "keys": "alt+shift+up", "id": "Terminal.ResizePaneUp" }

Parametri

Contrassegna un riquadro come di sola lettura

È possibile contrassegnare un riquadro come di sola lettura, il che impedirà l'input nel buffer di testo. Se si tenta di chiudere o inserire testo in un riquadro di sola lettura, il terminale visualizzerà invece un avviso popup.

Nome del comando: toggleReadOnlyMode

ID predefinito:

{ "command": "toggleReadOnlyMode", "id": "Terminal.ToggleReadOnlyMode" }

È possibile abilitare la modalità di sola lettura in un riquadro. Questa operazione funziona in modo analogo all'attivazione/disattivazione, tuttavia non cambierà lo stato se attivata di nuovo.

Nome del comando: enableReadOnlyMode

ID predefinito:

{ "command": "enableReadOnlyMode", "id": "Terminal.EnableReadOnlyMode" }

È possibile disabilitare la modalità di sola lettura in un riquadro. Questa operazione funziona in modo analogo all'attivazione/disattivazione, tuttavia non cambierà lo stato se attivata di nuovo.

Nome del comando: disableReadOnlyMode

ID predefinito:

{ "command": "disableReadOnlyMode", "id": "Terminal.DisableReadOnlyMode" }

Riavvia un riquadro

Questo comando riavvia manualmente commandline nel riquadro attivo. Ciò è particolarmente utile per scenari come ssh, in cui potrebbe essere necessario riavviare una connessione senza chiudere il riquadro.

Si noti che questo terminerà il processo nel riquadro, se è attualmente in esecuzione.

Nome del comando: restartConnection

ID predefinito:

{ "command": "restartConnection", "id": "Terminal.RestartConnection" }

Comandi di integrazione degli Appunti

Copia

Copia il contenuto del terminale selezionato negli Appunti. Se non esiste alcuna selezione, l'accordo chiave viene inviato direttamente al terminale.

Nome del comando: copy

ID predefinito:

{ "command": { "action": "copy", "singleLine": false }, "id": "Terminal.CopyToClipboard" }

Associazioni predefinite:

{ "keys": "ctrl+c", "id": "Terminal.CopyToClipboard" },
{ "keys": "ctrl+shift+c", "id": "Terminal.CopyToClipboard" },
{ "keys": "ctrl+insert", "id": "Terminal.CopyToClipboard" },
{ "keys": "enter", "id": "Terminal.CopyToClipboard" }

Parametri

Incolla

Inserisce il contenuto copiato negli Appunti.

Nome del comando: paste

ID predefinito:

{ "command": "paste", "id": "Terminal.PasteFromClipboard" }

Associazioni predefinite:

{ "keys": "ctrl+v", "id": "Terminal.PasteFromClipboard" },
{ "keys": "ctrl+shift+v", "id": "Terminal.PasteFromClipboard" },
{ "keys": "shift+insert", "id": "Terminal.PasteFromClipboard" }

Espandi selezione alla parola

Se esiste una selezione, viene espansa in modo da includere completamente tutte le parole parzialmente selezionate.

Nome del comando: expandSelectionToWord

ID predefinito:

{ "command": "expandSelectionToWord", "id": "Terminal.ExpandSelectionToWord" }

Seleziona tutto

In questo modo viene selezionato tutto il contenuto nel buffer di testo.

Nome del comando: selectAll

ID predefinito:

{ "command": "selectAll", "id": "Terminal.SelectAll" }

Associazione predefinita:

{ "keys": "ctrl+shift+a", "id": "Terminal.SelectAll" }

Modalità contrassegno

In questo modo viene attivata o disattivata la modalità contrassegno. La modalità contrassegno è una modalità in cui è possibile usare la tastiera per creare una selezione nella posizione del cursore nel terminale.

Nome del comando: markMode

ID predefinito:

{ "command": "markMode", "id": "Terminal.ToggleMarkMode" }

Associazione predefinita:

{ "keys": "ctrl+shift+m", "id": "Terminal.ToggleMarkMode" }

Cambia evidenziatore di selezione

Quando si modifica una selezione usando la tastiera, si sposta un'estremità della selezione. È possibile usare questa azione per passare all'altro evidenziatore di selezione.

Nome del comando: switchSelectionEndpoint

ID predefinito:

{ "command": "switchSelectionEndpoint", "id": "Terminal.SwitchSelectionEndpoint" },

Attiva/Disattiva selezione blocco

Rende la selezione esistente una selezione di blocchi, ovvero l'area selezionata è un rettangolo, anziché il ritorno a capo all'inizio e alla fine di ogni riga.

Nome del comando: toggleBlockSelection

ID predefinito:

{ "command": "toggleBlockSelection", "id": "Terminal.ToggleBlockSelection" },

Comandi di scorrimento

Scorri verso l'alto

Scorre la schermata verso l'alto in base al numero di righe definite da "rowsToScroll". Se "rowsToScroll" non viene specificato, scorrerà verso l'alto la quantità definita dall'impostazione predefinita del sistema, che corrisponde alla stessa quantità di scorrimento del mouse.

Nome del comando: scrollUp

ID predefinito:

{ "command": "scrollUp", "id": "Terminal.ScrollUp" }

Associazione predefinita:

{ "keys": "ctrl+shift+up", "id": "Terminal.ScrollUp" }

Parametri

Scorri verso il basso

Scorre la schermata verso il basso in base al numero di righe definite da "rowsToScroll". Se "rowsToScroll" non viene specificato, scorrerà verso il basso la quantità definita dall'impostazione predefinita del sistema, che corrisponde alla stessa quantità di scorrimento del mouse.

Nome del comando: scrollDown

ID predefinito:

{ "command": "scrollDown", "id": "Terminal.ScrollDown" }

Associazione predefinita:

{ "keys": "ctrl+shift+down", "id": "Terminal.ScrollDown" }

Parametri

Scorri verso l'alto di una pagina intera

Scorre lo schermo verso l'alto di una pagina intera, che corrisponde all'altezza della finestra.

Nome del comando: scrollUpPage

ID predefinito:

{ "command": "scrollUpPage", "id": "Terminal.ScrollUpPage" }

Associazione predefinita:

{ "keys": "ctrl+shift+pgup", "id": "Terminal.ScrollUpPage" }

Scorri verso il basso di una pagina intera

Scorre lo schermo verso il basso di una pagina intera, che corrisponde all'altezza della finestra.

Nome del comando: scrollDownPage

ID predefinito:

{ "command": "scrollDownPage", "id": "Terminal.ScrollDownPage" }

Associazione predefinita:

{ "keys": "ctrl+shift+pgdn", "id": "Terminal.ScrollDownPage" }

Scorri fino al primo elemento della cronologia

Scorre la schermata fino alla parte superiore del buffer di input.

Nome del comando: scrollToTop

ID predefinito:

{ "command": "scrollToTop", "id": "Terminal.ScrollToTop" }

Associazione predefinita:

{ "keys": "ctrl+shift+home", "id": "Terminal.ScrollToTop" }

Scorrere fino all'ultimo elemento della cronologia

Scorre la schermata fino alla parte inferiore del buffer di input.

Nome del comando: scrollToBottom

ID predefinito:

{ "command": "scrollToBottom", "id": "Terminal.ScrollToBottom" }

Associazione predefinita:

{ "keys": "ctrl+shift+end", "id": "Terminal.ScrollToBottom" }

Cancella buffer

Questa azione può essere usata per cancellare manualmente il buffer del terminale. Ciò è utile per gli scenari in cui non si è seduti al prompt della shell della riga di comando e non è possibile eseguire Clear-Host/cls/clear facilmente.

Nome del comando: clearBuffer

ID predefinito:

{ "command": { "action": "clearBuffer", "clear": "all" }, "id": "Terminal.ClearBuffer" }

Parametri

Comandi di regolazione della visualizzazione

Regola dimensioni caratteri

Modifica le dimensioni del testo in base al numero di punti specificato.

Nome del comando: adjustFontSize

ID predefiniti:

{ "command": { "action": "adjustFontSize", "delta": 1 }, "id": "Terminal.IncreaseFontSize" },
{ "command": { "action": "adjustFontSize", "delta": -1 }, "id": "Terminal.DecreaseFontSize" }

Associazioni predefinite:

{ "keys": "ctrl+plus", "id": "Terminal.IncreaseFontSize" },
{ "keys": "ctrl+minus", "id": "Terminal.DecreaseFontSize" },
{ "keys": "ctrl+numpad_plus", "id": "Terminal.IncreaseFontSize" },
{ "keys": "ctrl+numpad_minus", "id": "Terminal.DecreaseFontSize" }

Parametri

Reimposta dimensioni del carattere

Reimposta le dimensioni del testo in base al valore predefinito.

Nome del comando: resetFontSize

ID predefinito:

{ "command": "resetFontSize", "id": "Terminal.ResetFontSize" }

Associazioni predefinite:

{ "keys": "ctrl+0", "id": "Terminal.ResetFontSize" },
{ "keys": "ctrl+numpad_0", "id": "Terminal.ResetFontSize" }

Regola opacità

In questo modo viene modificata l'opacità della finestra. Se relative è impostato su true, l'opacità verrà modificata rispetto all'opacità corrente. In caso contrario, l'opacità verrà impostata direttamente su opacity specificato

Nome del comando: adjustOpacity

Associazioni predefinite:

{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 0 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 25 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 50 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 75 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 100 } }

Parametri

Attiva/disattiva effetti pixel shader

In questo modo si attivano o disattivano gli effetti pixel shader abilitati nel terminale. Se l'utente ha specificato uno shader valido con experimental.pixelShaderPath, questa azione attiva/disattiva lo shader. In questo modo verrà attivato anche l'"effetto terminale retro", che è abilitato con l'impostazione del profilo experimental.retroTerminalEffect.

Nome del comando: toggleShaderEffects

ID predefinito:

{ "command": "toggleShaderEffects", "id": "Terminal.ToggleShaderEffects" }

Imposta la combinazione colori

Modifica la combinazione di colori attiva.

Nome del comando: setColorScheme

Parametri

Dichiarazione di esempio:

{ "command": { "action": "setColorScheme", "colorScheme": "Campbell" }, "id": "User.SetSchemeToCampbell" }

Aggiungi segno di scorrimento

Aggiunge un segno di scorrimento al buffer di testo. Se è presente una selezione, il segno viene posizionato nella selezione, altrimenti viene posizionato nella riga del cursore.

Nome del comando: addMark

Parametri

Dichiarazione di esempio:

{ "command": { "action": "addMark", "color": "#ff00ff" }, "id": "User.AddMark" }

Scorrere fino a contrassegnare

Scorre fino al segno di scorrimento nella direzione specificata. Per altre info, vedi Segni di scorrimento e Integrazione shell.

Nome del comando: scrollToMark

Parametri

Dichiarazione di esempio:

{ "command": { "action": "scrollToMark", "direction": "previous" }, "id": "User.ScrollToMark" }

Segno di cancellazione

Cancella il segno di scorrimento nella posizione corrente, in corrispondenza di una selezione se ne è presente una oppure nella posizione del cursore. Questa è una funzionalità in fase sperimentale e la sua permanenza non è assicurata.

Nome del comando: clearMark

Dichiarazione di esempio:

{ "command": { "action": "clearMark" }, "id": "User.ClearMark" }

Cancella tutti i segni

Cancella tutti i segni di scorrimento nel buffer di testo. Questa è una funzionalità in fase sperimentale e la sua permanenza non è assicurata.

Nome del comando: clearAllMarks

Dichiarazione di esempio:

{ "command": { "action": "clearAllMarks" }, "id": "User.ClearAllMarks" }

Suggerimenti

Apri menu Suggerimenti

Nome del comando: showSuggestions

Parametri

Origini dei suggerimenti

Sono supportate le origini di suggerimento seguenti:

• "recentCommands": il menu dei suggerimenti verrà popolato con i comandi usati più di recente. Queste sono basate sull'integrazione della shell, quindi saranno disponibili solo se la shell è configurata per supportare l'integrazione. Per altre informazioni, vedere Integrazione della shell.
• "tasks": il menu dei suggerimenti verrà popolato con tutte le azioni sendInput delle impostazioni.
• "all": usare tutte le origini dei suggerimenti.

Questi valori possono essere usati da soli come valore di parametro stringa o combinati come matrice. Ad esempio:

{ "command": { "action": "showSuggestions", "source": ["recentCommands", "tasks"] } },
{ "command": { "action": "showSuggestions", "source": "all" } },
{ "command": { "action": "showSuggestions", "source": "recentCommands" } },

Nell'esempio precedente, i primi due comandi apriranno il menu dei suggerimenti con i comandi e le attività recenti. Il terzo comando aprirà il menu dei suggerimenti con solo i comandi recenti.

Esportazione del buffer

Esporta buffer

In questo modo l'utente può esportare il testo del buffer in un file. Se il file non esiste, verrà creato automaticamente. Se il file esiste già, il relativo contenuto verrà sostituito con il testo del buffer del terminale.

Nome del comando: exportBuffer

ID predefinito:

{ "command": { "action": "exportBuffer" }, "id": "Terminal.ExportBuffer" }

Parametri

Comandi globali

Richiamo globale

Si tratta di un'azione speciale che funziona a livello globale nel sistema operativo, anziché solo nel contesto della finestra del terminale. Quando viene premuta, questa azione richiamerà la finestra del terminale. La finestra richiamata, la posizione di richiamo e il comportamento della finestra richiamata sono controllati dalle proprietà di questa azione.

Note

• I tasti associati alle azioni globalSummon nel terminale non funzioneranno in altre applicazioni mentre il terminale è in esecuzione. Porranno sempre il primo piano sulla finestra del terminale.

• Se un'altra applicazione in esecuzione si è già registrata per l'oggetto specificato keys usando l'API RegisterHotKey, il terminale non sarà in grado di fungere da listener per tali pressioni di tasi.

• Le istanze elevate e non elevate del terminale non saranno in grado di eseguire la registrazione per gli stessi tasti. Lo stesso vale sia per le versioni di anteprima che per le versioni stabili del terminale: la prima che si avvia avrà sempre la priorità.

• Queste pressioni di tasti funzioneranno solo quando un'istanza del terminale è già in esecuzione. Per avviare automaticamente il terminale all'accesso, vedere startOnUserLogin.

Nome del comando: globalSummon

Associazione predefinita:

Questo comando non è attualmente associato nelle impostazioni predefinite.

{ "command": { "action": "globalSummon" } }

Parametri

Quando name viene fornito con monitor o desktop, name si comporta nei modi seguenti:

• desktop
  • "any": passare al desktop in cui è già attiva la finestra specificata.
  • "toCurrent": se la finestra si trova in un altro desktop virtuale, spostarla in quella attualmente attiva.
  • "onCurrent": se la finestra si trova in un altro desktop virtuale, spostarla in quella attualmente attiva.
• monitor
  • "any": lasciare attiva la finestra sul monitor.
  • "toCurrent": se la finestra si trova in un altro monitor, spostarla nel monitor con la finestra in primo piano corrente.
  • "toMouse": se la finestra si trova in un altro monitor, spostarla nel monitor con il cursore del mouse.

Le proprietà desktop e monitor possono essere combinate nei modi seguenti:

Esempi

// Summon the most recently used (MRU) window, to the current virtual desktop,
// to the monitor the mouse cursor is on, without an animation. If the window is
// already in the foreground, then minimize it.
{ "command": { "action": "globalSummon" }, "id": "User.MyGlobalSummon" },

// Summon the MRU window, by going to the virtual desktop the window is
// currently on. Move the window to the monitor the mouse is on.
{ "command": { "action": "globalSummon", "desktop": "any" }, "id": "User.MyGlobalSummonAnyDesktop" },

// Summon the MRU window to the current desktop, leaving the position of the window untouched.
{ "command": { "action": "globalSummon", "monitor": "any" }, "id": "User.MyGlobalSummonAnyMonitor" },

// Summon the MRU window, by going to the virtual desktop the window is
// currently on, leaving the position of the window untouched.
{ "command": { "action": "globalSummon", "desktop": "any", "monitor": "any" }, "id": "User.MyGlobalSummonAnywhere" },

// Summon the MRU window with a dropdown duration of 200ms.
{ "command": { "action": "globalSummon", "dropdownDuration": 200 }, "id": "User.MyGlobalSummonDrop" },

// Summon the MRU window. If the window is already in the foreground, do nothing.
{ "command": { "action": "globalSummon", "toggleVisibility": false }, "id": "User.MyGlobalSummonIfNotVisible" },

// Summon the window named "_quake". If no window with that name exists, then create a new window.
{ "command": { "action": "globalSummon", "name": "_quake" }, "id": "User.MyGlobalSummonQuake" }

Aprire la finestra modalità di esecuzione del quake

{
"id": "User.MySummonQuake",
"command": {
"action": "globalSummon",
"name": "_quake",
"dropdownDuration": 200,
"toggleVisibility": true,
"monitor": "toMouse",
"desktop": "toCurrent"
}
}

{ "command": "quakeMode", "id": "Terminal.QuakeMode" }

Esegui più azioni

Questa azione consente all'utente di associare più azioni sequenziali a un comando. Queste azioni non supportano gli ID.

Nome del comando: multipleActions

Parametri

Esempio

{ "name": "Create My Layout", "command": {
    "action": "multipleActions",
    "actions": [
        // Create a new tab with 3 panes
        { "action": "newTab", "tabTitle": "Work", "colorScheme": "One Half Dark" },
        { "action": "splitPane", "split": "vertical", "profile": "Windows PowerShell", "tabTitle": "Work", "colorScheme": "Campbell Powershell", },
        { "action": "splitPane", "split": "horizontal", "profile": "Windows PowerShell", "tabTitle": "Work", "colorScheme": "Campbell Powershell", },

        // Create a second tab
        { "action": "newTab", "tabTitle": "Misc"},

        // Go back to the first tab and zoom the first pane
        { "action": "prevTab", "tabSwitcherMode": "disabled" },
        { "action": "moveFocus", "direction": "first"},
        "togglePaneZoom"
        ]
}}

Disassocia tasti (disabilita i tasti di scelta rapida)

È possibile disabilitare i tasti di scelta rapida o "scollegare" i tasti associati da qualsiasi comando. Questa operazione può essere necessaria quando si usano applicazioni terminale sottostanti, ad esempio VIM. Il tasto non associato passerà al terminale sottostante.

Nome del comando: unbound

Esempio di utilizzo delle disassociazioni:

Ad esempio, per scollegare i tasti di scelta rapida ALT+MAIUSC+-" e ALT+MAIUSC+=", includere questi comandi nella actions sezione del file settings.json.

{
    "keybindings": [
        { "id": "unbound", "keys": "alt+shift+-" },
        { "id": "unbound", "keys": "alt+shift+=" }
    ]
}

Esempio di utilizzo di null:

È anche possibile scollegare una sequenza di tasti associata per impostazione predefinita a un'azione impostando "id" su null. Ciò consentirà anche di associare la sequenza di tasti all'impostazione dell'applicazione della riga di comando anziché eseguire l'azione predefinita.

{
   "id" : null, "keys" : ["ctrl+v"]
}

Scenario di caso d'uso:

Terminale Windows usa l'associazione di tasti di scelta rapidaCTRL+V come comando incolla. Quando si usa una riga di comando WSL, è possibile usare un'applicazione Linux come Vim per modificare i file. Tuttavia, Vim si basa sull'associazione di tasti CTRL+V per usare la modalità visiva in senso blocco. Questa associazione di tasti verrà bloccata, con il comando incolla Terminale Windows che avrà priorità, a meno che l'impostazione unbound non venga modificata nel file settings.json in modo che l'associazione di tasti venga associata all'app della riga di comando Vim, anziché all'associazione Terminale Windows.