Klucze dostępu VisualElement w systemie Windows

Klawisze dostępu to skróty klawiaturowe, które zwiększają użyteczność i dostępność aplikacji w systemie Windows, zapewniając intuicyjny sposób szybkiego nawigowania po widocznym interfejsie użytkownika aplikacji i interakcji z nią za pomocą klawiatury zamiast za pomocą dotyku lub myszy. Są to kombinacje klawisza Alt i co najmniej jednego klawisza alfanumerycznego, zwykle naciskanych sekwencyjnie. Skróty klawiaturowe są automatycznie obsługiwane w przypadku kluczy dostępu korzystających z pojedynczego znaku alfanumerycznego.

Porady dotyczące klucza dostępu to przestawne znaczki wyświetlane obok kontrolek zawierających klucze dostępu. Każda porada klucza dostępu zawiera klucze alfanumeryczne, które aktywują skojarzona kontrolkę. Gdy użytkownik naciśnie klawisz Alt, zostaną wyświetlone porady dotyczące klawisza dostępu.

Ten wieloplatformowy interfejs użytkownika aplikacji platformy .NET (.NET MAUI) systemu Windows służy do określania klucza dostępu dla elementu VisualElement. Jest on używany w języku XAML, ustawiając VisualElement.AccessKey dołączoną właściwość na wartość alfanumeryczną, a opcjonalnie ustawiając VisualElement.AccessKeyPlacement dołączoną właściwość na wartość AccessKeyPlacement wyliczenia, VisualElement.AccessKeyHorizontalOffset dołączoną właściwość do doubleelementu i VisualElement.AccessKeyVerticalOffset dołączoną właściwość do doubleelementu :

<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>

Alternatywnie można go używać z poziomu języka C# przy użyciu płynnego interfejsu API:

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);
...

Metoda VisualElement.On<Microsoft.Maui.Controls.PlatformConfiguration.Windows> określa, że ta platforma będzie działać tylko w systemie Windows. Metoda VisualElement.SetAccessKey w Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific przestrzeni nazw służy do ustawiania wartości klucza dostępu dla VisualElement. Metoda VisualElement.SetAccessKeyPlacement , opcjonalnie określa pozycję do użycia do wyświetlania końcówki klucza dostępu, z AccessKeyPlacement wyliczeniem zawierającym następujące możliwe wartości:

• Auto — wskazuje, że umieszczanie wskazówek klucza dostępu zostanie określone przez system operacyjny.
• Top— wskazuje, że wskazówka klucza dostępu będzie wyświetlana nad górną krawędzią .VisualElement
• Bottom— wskazuje, że porada klucza dostępu będzie wyświetlana poniżej dolnej krawędzi .VisualElement
• Right — wskazuje, że porada klucza dostępu będzie widoczna po prawej stronie prawej krawędzi VisualElement.
• Left— wskazuje, że porada klucza dostępu będzie widoczna po lewej stronie lewej krawędzi .VisualElement
• Center — wskazuje, że na środku obiektu VisualElementpojawi się przeładuj porada klucza dostępu.

Uwaga

Zazwyczaj umieszczanie Auto kluczowych wskazówek jest wystarczające, co obejmuje obsługę adaptacyjnego interfejsu użytkownika.

Metody VisualElement.SetAccessKeyHorizontalOffset i VisualElement.SetAccessKeyVerticalOffset mogą służyć do bardziej szczegółowej kontroli lokalizacji klucza dostępu. Argument SetAccessKeyHorizontalOffset metody wskazuje, jak daleko przenieść wskazówkę klucza dostępu w lewo lub w prawo, a argument SetAccessKeyVerticalOffset do metody wskazuje, jak daleko przenieść końcówkę klucza dostępu w górę lub w dół.

Uwaga

Nie można ustawić przesunięć wskazówek klucza dostępu, gdy ustawiono Autoumieszczanie klucza dostępu.

Ponadto GetAccessKeymetody , GetAccessKeyPlacement, GetAccessKeyHorizontalOffseti GetAccessKeyVerticalOffset mogą służyć do pobierania wartości klucza dostępu i lokalizacji.

Wynikiem jest to, że wskazówki dotyczące klucza dostępu można wyświetlić obok wszystkich VisualElement wystąpień definiujących klucze dostępu, naciskając klawisz Alt:

Gdy użytkownik aktywuje klucz dostępu, naciskając klawisz Alt, po którym następuje klucz dostępu, zostanie wykonana domyślna akcja dla elementu VisualElement . Na przykład gdy użytkownik aktywuje klucz dostępu w obiekcie Switch, Switch parametr jest przełączany. Gdy użytkownik aktywuje klucz dostępu na obiekcie Entry, Entry zyska fokus. Gdy użytkownik aktywuje klucz dostępu w obiekcie Button, jest wykonywana procedura obsługi zdarzeń dla Clicked zdarzenia.

Aby uzyskać więcej informacji na temat kluczy dostępu, zobacz Klucze dostępu.