Chiavi di accesso di VisualElement in Windows

I tasti di scelta rapida sono tasti di scelta rapida che migliorano l'usabilità e l'accessibilità delle app in Windows offrendo agli utenti un modo intuitivo per spostarsi rapidamente e interagire con l'interfaccia utente visibile dell'app tramite una tastiera anziché tramite tocco o mouse. Sono combinazioni del tasto ALT e di uno o più tasti alfanumerici, in genere premuti in sequenza. I tasti di scelta rapida sono supportati automaticamente per i tasti di scelta che usano un singolo carattere alfanumerico.

I suggerimenti per i tasti di scelta sono badge mobili visualizzati accanto ai controlli che includono i tasti di scelta. Ogni suggerimento per i tasti di scelta contiene i tasti alfanumerici che attivano il controllo associato. Quando un utente preme il tasto ALT, vengono visualizzati i suggerimenti per i tasti di scelta.

Questa piattaforma Windows specifica della piattaforma .NET multipiattaforma (.NET MAUI) viene usata per specificare una chiave di accesso per un oggetto VisualElement. Viene utilizzata in XAML impostando la VisualElement.AccessKey proprietà associata su un valore alfanumerico e, facoltativamente, impostando la VisualElement.AccessKeyPlacement proprietà associata su un valore dell'enumerazione AccessKeyPlacement , la VisualElement.AccessKeyHorizontalOffset proprietà associata a un doubleoggetto e la VisualElement.AccessKeyVerticalOffset proprietà associata a un doubleoggetto :

<TabbedPage ...
            xmlns:windows="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific;assembly=Microsoft.Maui.Controls">
    <ContentPage Title="Page 1"
                 windows:VisualElement.AccessKey="1">
        <StackLayout>
            ...
            <Switch windows:VisualElement.AccessKey="A" />
            <Entry Placeholder="Enter text here"
                   windows:VisualElement.AccessKey="B" />
            ...
            <Button Text="Access key F, placement top with offsets"
                    Clicked="OnButtonClicked"
                    windows:VisualElement.AccessKey="F"
                    windows:VisualElement.AccessKeyPlacement="Top"
                    windows:VisualElement.AccessKeyHorizontalOffset="20"
                    windows:VisualElement.AccessKeyVerticalOffset="20" />
            ...
        </StackLayout>
    </ContentPage>
    ...
</TabbedPage>

In alternativa, può essere usato da C# usando l'API Fluent:

using Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific;
...

var page = new ContentPage { Title = "Page 1" };
page.On<Microsoft.Maui.Controls.PlatformConfiguration.Windows>().SetAccessKey("1");

var switchView = new Switch();
switchView.On<Microsoft.Maui.Controls.PlatformConfiguration.Windows>().SetAccessKey("A");
var entry = new Entry { Placeholder = "Enter text here" };
entry.On<Microsoft.Maui.Controls.PlatformConfiguration.Windows>().SetAccessKey("B");
...

var button4 = new Button { Text = "Access key F, placement top with offsets" };
button4.Clicked += OnButtonClicked;
button4.On<Microsoft.Maui.Controls.PlatformConfiguration.Windows>()
    .SetAccessKey("F")
    .SetAccessKeyPlacement(AccessKeyPlacement.Top)
    .SetAccessKeyHorizontalOffset(20)
    .SetAccessKeyVerticalOffset(20);
...

Il VisualElement.On<Microsoft.Maui.Controls.PlatformConfiguration.Windows> metodo specifica che questa specifica della piattaforma verrà eseguita solo in Windows. Il VisualElement.SetAccessKey metodo , nello spazio dei Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific nomi , viene usato per impostare il valore della chiave di accesso per .VisualElement Il VisualElement.SetAccessKeyPlacement metodo, facoltativamente, specifica la posizione da utilizzare per visualizzare il suggerimento per i tasti di scelta, con l'enumerazione AccessKeyPlacement che fornisce i valori possibili seguenti:

• Auto – indica che il posizionamento del suggerimento per i tasti di scelta sarà determinato dal sistema operativo.
• Top : indica che il suggerimento per il tasto di scelta verrà visualizzato sopra il bordo superiore di VisualElement.
• Bottom : indica che il suggerimento per il tasto di scelta verrà visualizzato sotto il bordo inferiore di VisualElement.
• Right : indica che il suggerimento per il tasto di scelta verrà visualizzato a destra del bordo destro dell'oggetto VisualElement.
• Left – indica che il suggerimento per il tasto di scelta verrà visualizzato a sinistra del bordo sinistro dell'oggetto VisualElement.
• Center – indica che il suggerimento per il tasto di scelta verrà visualizzato sovrapposto al centro di VisualElement.

Nota

In genere, il posizionamento della Auto descrizione chiave è sufficiente, che include il supporto per le interfacce utente adattive.

I VisualElement.SetAccessKeyHorizontalOffset metodi e VisualElement.SetAccessKeyVerticalOffset possono essere usati per un controllo più granulare della posizione del suggerimento per i tasti di scelta. L'argomento del SetAccessKeyHorizontalOffset metodo indica la distanza per spostare il suggerimento del tasto di scelta verso sinistra o destra e l'argomento al metodo indica la distanza per spostare la descrizione del tasto di scelta verso l'alto o verso il SetAccessKeyVerticalOffset basso.

Nota

Gli offset della descrizione chiave di accesso non possono essere impostati quando il posizionamento del tasto di scelta è impostato Auto.

Inoltre, i GetAccessKeymetodi , GetAccessKeyPlacementGetAccessKeyHorizontalOffset, e GetAccessKeyVerticalOffset possono essere usati per recuperare un valore della chiave di accesso e la relativa posizione.

Il risultato è che i suggerimenti per i tasti di scelta possono essere visualizzati accanto a tutte VisualElement le istanze che definiscono i tasti di scelta premendo ALT:

Quando un utente attiva un tasto di scelta, premendo ALT seguito dal tasto di scelta, verrà eseguita l'azione predefinita per .VisualElement Ad esempio, quando un utente attiva la chiave di accesso in un Switchoggetto , l'oggetto Switch viene attivato o disattivato. Quando un utente attiva il tasto di scelta su un Entryoggetto , ottiene lo Entry stato attivo. Quando un utente attiva la chiave di accesso in un Buttonoggetto , viene eseguito il gestore eventi per l'evento Clicked .

Per altre informazioni sulle chiavi di accesso, vedere Chiavi di accesso.