Condividi tramite


Acceleratori tramite tastiera

Immagine hero della tastiera di Surface

I tasti di scelta rapida (o i tasti di scelta rapida) sono tasti di scelta rapida che migliorano l'usabilità e l'accessibilità delle applicazioni Windows offrendo agli utenti un modo intuitivo per richiamare azioni o comandi comuni senza spostarsi nell'interfaccia utente dell'app.

Nota

Una tastiera è indispensabile per gli utenti con determinate disabilità (vedere Accessibilità da tastiera) ed è anche uno strumento importante per gli utenti che la considerano un modo più efficiente per interagire con un'app.

Per informazioni dettagliate sull'esplorazione dell'interfaccia utente di un'applicazione Windows con tasti di scelta rapida, vedere l'argomento Tasti di scelta rapida.

Per creare tasti di scelta rapida personalizzati, vedere l'argomento Eventi da tastiera.

Panoramica

Gli acceleratori sono costituiti da due tipi di tasti: modificatori e non modificatori. I tasti di modifica includono Maiusc, Menu, Controllo e il tasto Windows, esposti tramite VirtualKeyModifiers. I non modificatori includono Virtualkey, ad esempio Delete, F3, Spacebar, Arrow, Esc e tutti i tasti alfanumerici e di punteggiatura.

Nota

Gli acceleratori includono in genere i tasti di funzione da F1 a F12 o una combinazione di un tasto standard associato a uno o più tasti di modifica (CTRL, MAIUSC). Ad esempio, se un utente preme CTRL+MAIUSC+M, il framework controlla i modificatori (CTRL e MAIUSC) e attiva l'acceleratore, se esistente.

Molti controlli XAML hanno acceleratori di tastiera predefiniti. Ad esempio, ListView supporta CTRL+A per la selezione di tutti gli elementi nell'elenco e RichEditBox supporta CTRL+TAB per l'inserimento di una scheda nella casella di testo. Questi tasti di scelta rapida predefiniti vengono definiti acceleratori di controllo e vengono eseguiti solo se lo stato attivo è sull'elemento o su uno dei relativi elementi figlio. Gli acceleratori definiti dall'utente che usano le API dell'acceleratore di tastiera descritte di seguito sono denominati acceleratori di app.

I tasti di scelta rapida non sono disponibili per ogni azione, ma sono spesso associati ai comandi esposti nei menu e devono essere specificati con il contenuto della voce di menu. Gli acceleratori possono anche essere associati ad azioni che non dispongono di voci di menu equivalenti. Tuttavia, poiché gli utenti si basano sui menu di un'applicazione per individuare e apprendere il set di comandi disponibile, è consigliabile provare a individuare i tasti di scelta rapida il più facilmente possibile (l'uso di etichette o modelli stabiliti può risultare utile.

Un acceleratore ripete automaticamente (ad esempio, quando l'utente preme CTRL+MAIUSC e quindi tiene premuto M, l'acceleratore viene richiamato ripetutamente fino a quando M non viene rilasciato). Questo comportamento non può essere modificato.

Screenshot degli acceleratori di tastiera in un'etichetta di voce di menu.
Tasti di scelta rapida descritti in un'etichetta di voce di menu

Quando usare i tasti di scelta rapida

Ti consigliamo di specificare i tasti di scelta rapida ovunque sia appropriato nell'interfaccia utente e di supportare gli acceleratori in tutti i controlli personalizzati.

  • Gli acceleratori da tastiera rendono l'app più accessibile per gli utenti con disabilità motorie, inclusi gli utenti che possono premere un solo tasto alla volta o che hanno difficoltà a usare un mouse.

    Un'interfaccia utente della tastiera ben progettata è un aspetto importante dell'accessibilità software. Consente agli utenti ipovedenti o con determinate disabilità motorie di navigare in un'app e di interagire con le sue funzionalità. Questi utenti potrebbero non essere in grado di usare un mouse, pertanto usano varie tecnologie assistive come gli strumenti di miglioramento della tastiera, le tastiere su schermo, gli ingrandimenti dello schermo, i lettori su schermo e le utilità di input vocale. Per questi utenti, la copertura completa dei comandi è fondamentale.

  • Gli acceleratori da tastiera facilitano l'uso dell'app agli utenti esperti che preferiscono interagire tramite tastiera.

    Gli utenti esperti spesso preferiscono usare la tastiera perché i comandi basati su tastiera possono essere immessi più rapidamente e non richiedono loro di rimuovere le mani dalla tastiera. Per questi utenti, l'efficienza e la coerenza sono fondamentali; la completezza è importante solo per i comandi usati più di frequente.

Specificare un acceleratore da tastiera

Usare le API KeyboardAccelerator per creare acceleratori di tastiera nelle app di Windows. Con queste API non è necessario gestire più eventi KeyDown per rilevare la combinazione di tasti premuta ed è possibile localizzare gli acceleratori nelle risorse dell'app.

Ti consigliamo di impostare gli acceleratori da tastiera rapida per le azioni più comuni nell'app e documentarle usando l'etichetta della voce di menu o la descrizione comando. In questo esempio vengono dichiarati acceleratori di tastiera solo per i comandi Rinomina e Copia.

<CommandBar Margin="0,200" AccessKey="M">
  <AppBarButton 
    Icon="Share" 
    Label="Share" 
    Click="OnShare" 
    AccessKey="S" />
  <AppBarButton 
    Icon="Copy" 
    Label="Copy" 
    ToolTipService.ToolTip="Copy (Ctrl+C)" 
    Click="OnCopy" 
    AccessKey="C">
    <AppBarButton.KeyboardAccelerators>
      <KeyboardAccelerator 
        Modifiers="Control" 
        Key="C" />
    </AppBarButton.KeyboardAccelerators>
  </AppBarButton>

  <AppBarButton 
    Icon="Delete" 
    Label="Delete" 
    Click="OnDelete" 
    AccessKey="D" />
  <AppBarSeparator/>
  <AppBarButton 
    Icon="Rename" 
    Label="Rename" 
    ToolTipService.ToolTip="Rename (F2)" 
    Click="OnRename" 
    AccessKey="R">
    <AppBarButton.KeyboardAccelerators>
      <KeyboardAccelerator 
        Modifiers="None" Key="F2" />
    </AppBarButton.KeyboardAccelerators>
  </AppBarButton>

  <AppBarButton 
    Icon="SelectAll" 
    Label="Select" 
    Click="OnSelect" 
    AccessKey="A" />
  
  <CommandBar.SecondaryCommands>
    <AppBarButton 
      Icon="OpenWith" 
      Label="Sources" 
      AccessKey="S">
      <AppBarButton.Flyout>
        <MenuFlyout>
          <ToggleMenuFlyoutItem Text="OneDrive" />
          <ToggleMenuFlyoutItem Text="Contacts" />
          <ToggleMenuFlyoutItem Text="Photos"/>
          <ToggleMenuFlyoutItem Text="Videos"/>
        </MenuFlyout>
      </AppBarButton.Flyout>
    </AppBarButton>
    <AppBarToggleButton 
      Icon="Save" 
      Label="Auto Save" 
      IsChecked="True" 
      AccessKey="A"/>
  </CommandBar.SecondaryCommands>

</CommandBar>

Screenshot di un acceleratore di tastiera in una descrizione comando.
Acceleratore di tastiera descritto in una descrizione comando

L'oggetto UIElement include un insieme KeyboardAccelerator, KeyboardAccelerators, in cui si specificano gli oggetti KeyboardAccelerator personalizzati e si definiscono le sequenze di tasti per l'acceleratore di tastiera:

Nota

Sono supportati tasti singoli (A, Elimina, F2, Barra spaziatrice, Esc, Tasto multimediale) e tasti di scelta rapida multichiavi (CTRL+MAIUSC+M). Tuttavia, i tasti virtuali game pad non sono supportati.

Acceleratori con ambito

Alcuni acceleratori funzionano solo in ambiti specifici, mentre altri funzionano a livello di app.

Ad esempio, Microsoft Outlook include gli acceleratori seguenti:

  • CTRL+B, CTRL+I e ESC funzionano solo nell'ambito del modulo di invio di posta elettronica
  • CTRL+1 e CTRL+2 funzionano a livello di app

Menu di scelta rapida

Le azioni del menu di scelta rapida influiscono solo su aree o elementi specifici, ad esempio i caratteri selezionati in un editor di testo o un brano in una playlist. Per questo motivo, è consigliabile impostare l'ambito degli acceleratori di tastiera per le voci di menu di scelta rapida sull'elemento padre del menu di scelta rapida.

Utilizzare la proprietà ScopeOwner per specificare l'ambito dell'acceleratore da tastiera. Questo codice illustra come implementare un menu di scelta rapida in un controllo ListView con acceleratori di tastiera con ambito:

<ListView x:Name="MyList">
  <ListView.ContextFlyout>
    <MenuFlyout>
      <MenuFlyoutItem Text="Share" Icon="Share"/>
      <MenuFlyoutItem Text="Copy" Icon="Copy">
        <MenuFlyoutItem.KeyboardAccelerators>
          <KeyboardAccelerator 
            Modifiers="Control" 
            Key="C" 
            ScopeOwner="{x:Bind MyList }" />
        </MenuFlyoutItem.KeyboardAccelerators>
      </MenuFlyoutItem>
      
      <MenuFlyoutItem Text="Delete" Icon="Delete" />
      <MenuFlyoutSeparator />
      
      <MenuFlyoutItem Text="Rename">
        <MenuFlyoutItem.KeyboardAccelerators>
          <KeyboardAccelerator 
            Modifiers="None" 
            Key="F2" 
            ScopeOwner="{x:Bind MyList}" />
        </MenuFlyoutItem.KeyboardAccelerators>
      </MenuFlyoutItem>
      
      <MenuFlyoutItem Text="Select" />
    </MenuFlyout>
    
  </ListView.ContextFlyout>
    
  <ListViewItem>Track 1</ListViewItem>
  <ListViewItem>Alternative Track 1</ListViewItem>

</ListView>

L'attributo ScopeOwner dell'elemento MenuFlyoutItem.KeyboardAccelerators contrassegna l'acceleratore come ambito anziché globale (il valore predefinito è null o globale). Per altri dettagli, vedere la sezione Risoluzione degli acceleratori più avanti in questo argomento.

Richiama un acceleratore da tastiera

L'oggetto KeyboardAccelerator usa il pattern di controllo Automazione interfaccia utente (UIA) per intervenire quando viene richiamato un acceleratore.

L'interfaccia utente [pattern di controllo] espone funzionalità di controllo comuni. Ad esempio, il controllo Button implementa il pattern di controllo Invoke per supportare l'evento Click (in genere viene richiamato un controllo facendo clic, facendo doppio clic o premendo INVIO, una scelta rapida da tastiera predefinita o un'altra combinazione di sequenze di tasti). Quando un acceleratore di tastiera viene usato per richiamare un controllo, il framework XAML cerca se il controllo implementa il pattern di controllo Invoke e, in tal caso, lo attiva (non è necessario ascoltare l'evento KeyboardAcceleratorInvoked).

Nell'esempio seguente, Control+S attiva l'evento Click perché il pulsante implementa il modello Invoke.

<Button Content="Save" Click="OnSave">
  <Button.KeyboardAccelerators>
    <KeyboardAccelerator Key="S" Modifiers="Control" />
  </Button.KeyboardAccelerators>
</Button>

Se un elemento implementa più pattern di controllo, solo uno può essere attivato tramite un acceleratore. I pattern di controllo sono classificati in ordine di priorità come indicato di seguito:

  1. Richiama (pulsante)
  2. Attiva/disattiva (casella di controllo)
  3. Selezione (ListView)
  4. Espandi/Comprimi (ComboBox)

Se non viene identificata alcuna corrispondenza, l'acceleratore non è valido e viene fornito un messaggio di debug ("Nessun modello di automazione per questo componente trovato. Implementare tutto il comportamento desiderato nell'evento Richiamato. L'impostazione di Handled su true nel gestore eventi elimina questo messaggio.")

Comportamento dell'acceleratore di tastiera personalizzato

L'evento Richiamato dell'oggetto KeyboardAccelerator viene generato quando viene eseguito l'acceleratore. L'oggetto evento KeyboardAcceleratorInvokedEventArgs include le proprietà seguenti:

  • Gestito (booleano): l'impostazione di questa proprietà su true impedisce l'attivazione del pattern di controllo e arresta il bubbling dell'evento dell'acceleratore. L'impostazione predefinita è false.
  • Elemento (DependencyObject): oggetto associato all'acceleratore.
  • KeyboardAccelerator: l'acceleratore di tastiera usato per generare l'evento Richiamato.

Di seguito viene illustrato come definire una raccolta di tasti di scelta rapida per gli elementi in un controllo ListView e come gestire l'evento Richiamato per ogni acceleratore.

<ListView x:Name="MyListView">
  <ListView.KeyboardAccelerators>
    <KeyboardAccelerator Key="A" Modifiers="Control,Shift" Invoked="SelectAllInvoked" />
    <KeyboardAccelerator Key="F5" Invoked="RefreshInvoked"  />
  </ListView.KeyboardAccelerators>
</ListView>
void SelectAllInvoked(KeyboardAccelerator sender, KeyboardAcceleratorInvokedEventArgs args)
{
  MyListView.SelectAll();
  args.Handled = true;
}

void RefreshInvoked(KeyboardAccelerator sender, KeyboardAcceleratorInvokedEventArgs args)
{
  MyListView.SelectionMode = ListViewSelectionMode.None;
  MyListView.SelectionMode = ListViewSelectionMode.Multiple;
  args.Handled = true;
}

Eseguire l'override del comportamento predefinito della tastiera

Alcuni controlli, quando hanno lo stato attivo, supportano acceleratori di tastiera predefiniti che eseguono l'override di qualsiasi acceleratore definito dall'app. Ad esempio, quando un controllo TextBox ha lo stato attivo, l'acceleratore Control+C copia solo il testo attualmente selezionato (gli acceleratori definiti dall'app vengono ignorati e non viene eseguita alcuna altra funzionalità).

Anche se non è consigliabile eseguire l'override dei comportamenti di controllo predefiniti a causa della familiarità dell'utente e delle aspettative, è possibile eseguire l'override dell'acceleratore di tastiera predefinito di un controllo. L'esempio seguente illustra come eseguire l'override dell'acceleratore di tastiera Control+C per un controllo TextBox tramite il gestore eventi PreviewKeyDown :

 private void TextBlock_PreviewKeyDown(object sender, KeyRoutedEventArgs e)
 {
    var ctrlState = CoreWindow.GetForCurrentThread().GetKeyState(Windows.System.VirtualKey.Control);
    var isCtrlDown = ctrlState == CoreVirtualKeyStates.Down || ctrlState 
        ==  (CoreVirtualKeyStates.Down | CoreVirtualKeyStates.Locked);
    if (isCtrlDown && e.Key == Windows.System.VirtualKey.C)
    {
        // Your custom keyboard accelerator behavior.
        
        e.Handled = true;
    }
 }

Disabilitare un acceleratore da tastiera

Se un controllo è disabilitato, viene disabilitato anche l'acceleratore associato. Nell'esempio seguente, poiché la proprietà IsEnabled di ListView è impostata su false, non è possibile richiamare l'acceleratore Control+A associato.

<ListView >
  <ListView.KeyboardAccelerators>
    <KeyboardAccelerator Key="A"
      Modifiers="Control"
      Invoked="CustomListViewSelecAllInvoked" />
  </ListView.KeyboardAccelerators>
  
  <TextBox>
    <TextBox.KeyboardAccelerators>
      <KeyboardAccelerator 
        Key="A" 
        Modifiers="Control" 
        Invoked="CustomTextSelecAllInvoked" 
        IsEnabled="False" />
    </TextBox.KeyboardAccelerators>
  </TextBox>

<ListView>

I controlli padre e figlio possono condividere lo stesso acceleratore. In questo caso, il controllo padre può essere richiamato anche se l'elemento figlio ha lo stato attivo e il relativo acceleratore è disabilitato.

Utilità per la lettura dello schermo e tasti di scelta rapida

Le utilità per la lettura dello schermo, ad esempio l'Assistente vocale, possono annunciare la combinazione di tasti di scelta rapida per gli utenti. Per impostazione predefinita, questo è ogni modificatore (nell'ordine di enumerazione VirtualModifiers) seguito dalla chiave (e separati dai segni "+"). È possibile personalizzare questa operazione tramite la proprietà associata AcceleratorKey AutomationProperties. Se viene specificato più di un acceleratore, viene annunciato solo il primo.

In questo esempio, AutomationProperty.AcceleratorKey restituisce la stringa "Control+SHIFT+A":

<ListView x:Name="MyListView">
  <ListView.KeyboardAccelerators>

    <KeyboardAccelerator 
      Key="A" 
      Modifiers="Control,Shift" 
      Invoked="CustomSelectAllInvoked" />
      
    <KeyboardAccelerator 
      Key="F5" 
      Modifiers="None" 
      Invoked="RefreshInvoked" />

  </ListView.KeyboardAccelerators>

</ListView>   

Nota

L'impostazione di AutomationProperties.AcceleratorKey non abilita la funzionalità della tastiera, ma indica solo al framework UIA quali tasti vengono usati.

Acceleratori di tastiera comuni

È consigliabile rendere coerenti gli acceleratori di tastiera tra le applicazioni Windows.

Gli utenti devono memorizzare gli acceleratori di tastiera e prevedere gli stessi risultati (o simili), ma questo potrebbe non essere sempre possibile a causa delle differenze di funzionalità tra le app.

Modifica Acceleratore di tastiera comune
Iniziare la modalità di modifica Ctrl + E
Selezionare tutti gli elementi in un controllo o una finestra con stato attivo CTRL + A
Ricerca e sostituzione CTRL+H
Annulla CTRL + Z
Ripeti CTRL + Y
Eliminare la selezione e copiarla negli Appunti CTRL + X
Copiare la selezione negli Appunti CTRL+C, CTRL+INSERISCI
Consente di incollare il contenuto degli Appunti. CTRL+V, MAIUSC+INSERISCI
Consente di incollare il contenuto degli Appunti (con opzioni) CTRL + ALT + V
Rinominare un elemento F2
Aggiunge un nuovo elemento CTRL+N
Aggiungere un nuovo elemento secondario CTRL+MAIUSC+N
Elimina elemento selezionato (con annulla) Canc, Ctrl+D
Elimina elemento selezionato (senza annulla) MAIUSC+CANC
Grassetto CTRL+B
Sottolineato CTRL+U
Italic CTRL+I
Navigazione
Trovare contenuto in un controllo attivo o in una finestra Ctrl +F
Passare al risultato di ricerca successivo F3
Passare al riquadro successivo dell'interfaccia utente F6
Passare al riquadro dell'interfaccia utente precedente MAIUSC + F6
Altre azioni
Aggiungi preferiti CTRL+D
Refresh F5 o CTRL+R
Zoom avanti Ctrl + +
Zoom out Ctrl + -
Zoom fino alla visualizzazione predefinita CTRL+0
Salva CTRL + S
Chiusura CTRL + W
Stampa CTRL+P

Si noti che alcune delle combinazioni non sono valide per le versioni localizzate di Windows. Ad esempio, nella versione spagnola di Windows viene usato CTRL+N per il grassetto anziché CTRL+B. Se l'app è localizzata, è consigliabile fornire acceleratori di tastiera localizzati.

Inviti di usabilità per acceleratori di tastiera

Descrizioni comandi

Poiché gli acceleratori da tastiera in genere non vengono descritti direttamente nell'interfaccia utente dell'applicazione Windows, è possibile migliorare la rilevabilità tramite descrizioni che vengono visualizzate automaticamente quando l'utente sposta lo stato attivo, tiene premuto o posiziona il puntatore del mouse su un controllo. La descrizione comando può identificare se un controllo ha un acceleratore di tastiera associato e, in tal caso, qual è la combinazione di tasti di scelta rapida.

Windows 10, versione 1803 (aggiornamento di aprile 2018) e versioni successive

Per impostazione predefinita, quando vengono dichiarati i tasti di scelta rapida, tutti i controlli (ad eccezione di MenuFlyoutItem e ToggleMenuFlyoutItem) presentano le combinazioni di tasti corrispondenti in una descrizione comando.

Nota

Se un controllo ha più di un acceleratore definito, viene presentato solo il primo.

Screenshot di un pulsante Salva con una descrizione comando sopra che indica il supporto per l'acceleratore CTRL+S.
Combinazione di tasti di scelta rapida nella descrizione comando

Per gli oggetti Button, AppBarButton e AppBarToggleButton , l'acceleratore di tastiera viene aggiunto alla descrizione comando predefinita del controllo. Per gli oggetti MenuFlyoutItem e ToggleMenuFlyoutItem , l'acceleratore di tastiera viene visualizzato con il testo del riquadro a comparsa.

Nota

Se si specifica una descrizione comando ,vedere Button1 nell'esempio seguente, viene eseguito l'override di questo comportamento.

<StackPanel x:Name="Container" Grid.Row="0" Background="AliceBlue">
    <Button Content="Button1" Margin="20"
            Click="OnSave" 
            KeyboardAcceleratorPlacementMode="Auto" 
            ToolTipService.ToolTip="Tooltip">
        <Button.KeyboardAccelerators>
            <KeyboardAccelerator  Key="A" Modifiers="Windows"/>
        </Button.KeyboardAccelerators>
    </Button>
    <Button Content="Button2"  Margin="20"
            Click="OnSave" 
            KeyboardAcceleratorPlacementMode="Auto">
        <Button.KeyboardAccelerators>
            <KeyboardAccelerator  Key="B" Modifiers="Windows"/>
        </Button.KeyboardAccelerators>
    </Button>
    <Button Content="Button3"  Margin="20"
            Click="OnSave" 
            KeyboardAcceleratorPlacementMode="Auto">
        <Button.KeyboardAccelerators>
            <KeyboardAccelerator  Key="C" Modifiers="Windows"/>
        </Button.KeyboardAccelerators>
    </Button>
</StackPanel>

Screenshot di tre pulsanti con etichetta Button1, Button2 e Button3 con una descrizione comando sopra Button2 che indica il supporto per l'acceleratore Windows+B.

Combinazione di tasti di scelta rapida aggiunta alla descrizione comando predefinita di Button

<AppBarButton Icon="Save" Label="Save">
    <AppBarButton.KeyboardAccelerators>
        <KeyboardAccelerator Key="S" Modifiers="Control"/>
    </AppBarButton.KeyboardAccelerators>
</AppBarButton>

Screenshot di un pulsante con un'icona Disco e una descrizione comando che include il testo salva predefinito aggiunto con l'acceleratore CTRL+S tra parentesi.

Combinazione di tasti di scelta rapida aggiunta alla descrizione comando predefinita di AppBarButton

<AppBarButton AccessKey="R" Icon="Refresh" Label="Refresh" IsAccessKeyScope="True">
    <AppBarButton.Flyout>
        <MenuFlyout>
            <MenuFlyoutItem AccessKey="A" Icon="Refresh" Text="Refresh A">
                <MenuFlyoutItem.KeyboardAccelerators>
                    <KeyboardAccelerator Key="R" Modifiers="Control"/>
                </MenuFlyoutItem.KeyboardAccelerators>
            </MenuFlyoutItem>
            <MenuFlyoutItem AccessKey="B" Icon="Globe" Text="Refresh B" />
            <MenuFlyoutItem AccessKey="C" Icon="Globe" Text="Refresh C" />
            <MenuFlyoutItem AccessKey="D" Icon="Globe" Text="Refresh D" />
            <ToggleMenuFlyoutItem AccessKey="E" Icon="Globe" Text="ToggleMe">
                <MenuFlyoutItem.KeyboardAccelerators>
                    <KeyboardAccelerator Key="Q" Modifiers="Control"/>
                </MenuFlyoutItem.KeyboardAccelerators>
            </ToggleMenuFlyoutItem>
        </MenuFlyout>
    </AppBarButton.Flyout>
</AppBarButton>

Screenshot di un menu con MenuFlyoutItems che includono combinazioni di tasti di scelta rapida.
Combinazione di tasti di scelta rapida aggiunta al testo di MenuFlyoutItem

Controllare il comportamento della presentazione usando la proprietà KeyboardAcceleratorPlacementMode , che accetta due valori: Auto o Hidden.

<Button Content="Save" Click="OnSave" KeyboardAcceleratorPlacementMode="Auto">
    <Button.KeyboardAccelerators>
        <KeyboardAccelerator Key="S" Modifiers="Control" />
    </Button.KeyboardAccelerators>
</Button>

In alcuni casi, potrebbe essere necessario presentare una descrizione comando rispetto a un altro elemento (in genere un oggetto contenitore).

Qui viene illustrato come usare la proprietà KeyboardAcceleratorPlacementTarget per visualizzare la combinazione di tasti di scelta rapida della tastiera per un pulsante Salva con il contenitore Grid anziché il pulsante .

<Grid x:Name="Container" Padding="30">
  <Button Content="Save"
    Click="OnSave"
    KeyboardAcceleratorPlacementMode="Auto"
    KeyboardAcceleratorPlacementTarget="{x:Bind Container}">
    <Button.KeyboardAccelerators>
      <KeyboardAccelerator  Key="S" Modifiers="Control" />
    </Button.KeyboardAccelerators>
  </Button>
</Grid>

Etichette

In alcuni casi, è consigliabile usare l'etichetta di un controllo per identificare se il controllo ha un acceleratore di tastiera associato e, in tal caso, qual è la combinazione di tasti di scelta rapida.

Alcuni controlli della piattaforma eseguono questa operazione per impostazione predefinita, in particolare gli oggetti MenuFlyoutItem e ToggleMenuFlyoutItem, mentre AppBarButton e AppBarToggleButton lo eseguono quando vengono visualizzati nel menu di overflow di CommandBar.

Tasti di scelta rapida descritti in un'etichetta di voce di menu.
Tasti di scelta rapida descritti in un'etichetta di voce di menu

È possibile eseguire l'override del testo dell'acceleratore predefinito per l'etichetta tramite la proprietà KeyboardAcceleratorTextOverride dei controlli MenuFlyoutItem, ToggleMenuFlyoutItem, AppBarButton e AppBarToggleButton (usare uno spazio singolo per nessun testo).

Nota

Il testo di override non viene presentato se il sistema non riesce a rilevare una tastiera collegata (è possibile controllarlo manualmente tramite la proprietà KeyboardPresent ).

Concetti avanzati

In questo caso vengono esaminati alcuni aspetti di basso livello dei tasti di scelta rapida.

Priorità dell'evento di input

Gli eventi di input si verificano in una sequenza specifica che è possibile intercettare e gestire in base ai requisiti dell'app.

Evento KeyDown/KeyUp bubbling

In XAML viene elaborata una sequenza di tasti come se fosse presente una sola pipeline di bubbling di input. Questa pipeline di input viene usata dagli eventi KeyDown/KeyUp e dall'input di caratteri. Ad esempio, se un elemento ha lo stato attivo e l'utente preme un tasto verso il basso, viene generato un evento KeyDown sull'elemento, seguito dall'elemento padre dell'elemento e così via verso l'alto fino agli argomenti. La proprietà gestita è true.

L'evento KeyDown viene usato anche da alcuni controlli per implementare gli acceleratori di controllo predefiniti. Quando un controllo ha un tasto di scelta rapida, gestisce l'evento KeyDown, il che significa che non ci sarà un bubbling dell'evento KeyDown. Ad esempio, RichEditBox supporta la copia con CTRL+C. Quando viene premuto CTRL, viene generato l'evento KeyDown e si fa bolle, ma quando l'utente preme C contemporaneamente, l'evento KeyDown viene contrassegnato come Handled e non viene generato (a meno che il parametro handledEventsToo di UIElement.AddHandler sia impostato su true).

Evento CharacterReceived

Quando l'evento CharacterReceived viene generato dopo l'evento KeyDown per controlli di testo come TextBox, è possibile annullare l'input di caratteri nel gestore eventi KeyDown.

Eventi PreviewKeyDown e PreviewKeyUp

Gli eventi di input di anteprima vengono attivati prima di qualsiasi altro evento. Se non gestisci questi eventi, viene attivato l'acceleratore per l'elemento con lo stato attivo, seguito dall'evento KeyDown. Entrambe le bolle di eventi fino a quando non vengono gestite.

Diagramma che mostra la sequenza di eventi chiaveSequenza di eventi chiave

Ordine degli eventi:

Eventi KeyDown di anteprima

Acceleratore app
Metodo OnKeyDown
Evento KeyDown
Acceleratori di app nell'elemento padre
Metodo OnKeyDown nell'elemento padre
Evento KeyDown nell'elemento padre
(Bolle alla radice)

Evento CharacterReceived
Eventi PreviewKeyUp
KeyUpEvents

Quando l'evento dell'acceleratore viene gestito, l'evento KeyDown viene contrassegnato anche come gestito. L'evento KeyUp rimane non gestito.

Risoluzione degli acceleratori

Bolle di eventi dell'acceleratore di tastiera dall'elemento con stato attivo fino alla radice. Se l'evento non viene gestito, il framework XAML cerca altri acceleratori di app senza ambito all'esterno del percorso di bubbling.

Quando vengono definiti due tasti di scelta rapida con la stessa combinazione di tasti, viene richiamato il primo acceleratore di tastiera presente nella struttura ad albero visuale.

Gli acceleratori di tastiera con ambito vengono richiamati solo quando lo stato attivo si trova all'interno di un ambito specifico. Ad esempio, in un controllo Grid che contiene decine di controlli, un acceleratore di tastiera può essere richiamato per un controllo solo quando lo stato attivo si trova all'interno di Grid (il proprietario dell'ambito).

Definizione dell'ambito degli acceleratori a livello di codice

Il metodo UIElement.TryInvokeKeyboardAccelerator richiama tutti gli acceleratori corrispondenti nel sottoalbero dell'elemento.

Il metodo UIElement.OnProcessKeyboardAccelerators viene eseguito prima dell'acceleratore di tastiera. Questo metodo passa un oggetto ProcessKeyboardAcceleratorArgs contenente il tasto, il modificatore e un valore Boolean che indica se l'acceleratore di tastiera è gestito. Se contrassegnato come gestito, l'acceleratore di tastiera viene contrassegnato come gestito( in modo che l'acceleratore di tastiera esterno non venga mai richiamato).

Nota

OnProcessKeyboardAccelerators viene sempre attivato, indipendentemente dal fatto che sia gestito o meno (simile all'evento OnKeyDown). È necessario verificare se l'evento è stato contrassegnato come gestito.

In questo esempio vengono usati OnProcessKeyboardAccelerators e TryInvokeKeyboardAccelerator per definire l'ambito degli acceleratori da tastiera all'oggetto Page:

protected override void OnProcessKeyboardAccelerators(
  ProcessKeyboardAcceleratorArgs args)
{
  if(args.Handled != true)
  {
    this.TryInvokeKeyboardAccelerator(args);
    args.Handled = true;
  }
}

Localizzare gli acceleratori

È consigliabile localizzare tutti i tasti di scelta rapida. È possibile eseguire questa operazione con il file delle risorse standard (con estensione resw) e l'attributo x:Uid nelle dichiarazioni XAML. In questo esempio, Windows Runtime carica automaticamente le risorse.

Diagramma della localizzazione dell'acceleratore di tastiera con il file di risorseLocalizzazione dell'acceleratore di tastiera con il file delle risorse

<Button x:Uid="myButton" Click="OnSave">
  <Button.KeyboardAccelerators>
    <KeyboardAccelerator x:Uid="myKeyAccelerator" Modifiers="Control"/>
  </Button.KeyboardAccelerators>
</Button>

Nota

Gli acceleratori da tastiera vengono implementati come tasti virtuali. Gli acceleratori localizzati devono essere scelti dalla raccolta predefinita di codici Virtual-Key (in caso contrario, si verificherà un errore del parser XAML).

Configurare un acceleratore a livello di codice

Di seguito è riportato un esempio di definizione a livello di codice di un acceleratore:

void AddAccelerator(
  VirtualKeyModifiers keyModifiers, 
  VirtualKey key, 
  TypedEventHandler<KeyboardAccelerator, KeyboardAcceleratorInvokedEventArgs> handler )
  {
    var accelerator = 
      new KeyboardAccelerator() 
      { 
        Modifiers = keyModifiers, Key = key
      };
    accelerator.Invoked += handler;
    this.KeyboardAccelerators.Add(accelerator);
  }

Nota

KeyboardAccelerator non è condivisibile, lo stesso KeyboardAccelerator non può essere aggiunto a più elementi.

Eseguire l'override del comportamento dell'acceleratore di tastiera

È possibile gestire l'evento KeyboardAccelerator.Invoked per eseguire l'override del comportamento predefinito keyboardAccelerator.

In questo esempio viene illustrato come eseguire l'override del comando "Select all" (CTRL+A keyboard accelerator) in un controllo ListView personalizzato. La proprietà Handled viene inoltre impostata su true per arrestare ulteriormente il bubbling dell'evento.

public class MyListView : ListView
{
  …
  protected override void OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs args) 
  {
    if(args.Accelerator.Key == VirtualKey.A 
      && args.Accelerator.Modifiers == KeyboardModifiers.Control)
    {
      CustomSelectAll(TypeOfSelection.OnlyNumbers); 
      args.Handled = true;
    }
  }
  …
}

Esempi