Přístupové klávesy VisualElement ve Windows

Přístupové klávesy jsou klávesové zkratky, které zlepšují použitelnost a přístupnost aplikací ve Windows tím, že uživatelům poskytují intuitivní způsob, jak rychle procházet a pracovat s viditelným uživatelským rozhraním aplikace pomocí klávesnice místo dotykového ovládání nebo myši. Jedná se o kombinace kláves Alt a jedné nebo více alfanumerických kláves, obvykle stisknuté postupně. Klávesové zkratky se automaticky podporují pro přístupové klávesy, které používají jeden alfanumerický znak.

Tipy pro přístupové klávesy jsou plovoucí odznáčky zobrazené vedle ovládacích prvků, které obsahují přístupové klíče. Každý tip přístupového klíče obsahuje alfanumerické klávesy, které aktivují přidružený ovládací prvek. Když uživatel stiskne klávesu Alt, zobrazí se tipy pro přístupové klávesy.

Toto uživatelské rozhraní pro víceplatformní aplikace .NET (.NET MAUI) pro Windows se používá k určení přístupového klíče pro VisualElement. Využívá se v XAML nastavením VisualElement.AccessKey připojené vlastnosti na alfanumerickou hodnotu a volitelně nastavením VisualElement.AccessKeyPlacement připojené vlastnosti na hodnotu AccessKeyPlacement výčtu, VisualElement.AccessKeyHorizontalOffset připojené vlastnosti doublea VisualElement.AccessKeyVerticalOffset připojené vlastnosti k double:

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

Alternativně ho můžete využívat z jazyka C# pomocí rozhraní FLUENT 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> určuje, že tato konkrétní platforma bude běžet pouze ve Windows. Metoda VisualElement.SetAccessKey v Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific oboru názvů slouží k nastavení hodnoty přístupového klíče pro VisualElement. Volitelně VisualElement.SetAccessKeyPlacement určuje pozici, která se má použít pro zobrazení tipu přístupového klíče, s AccessKeyPlacement výčtem, který poskytuje následující možné hodnoty:

• Auto – označuje, že umístění tipu přístupového klíče bude určeno operačním systémem.
• Top – označuje, že se nad horním okrajem VisualElementhorního okraje
• Bottom – označuje, že se popis přístupového klíče zobrazí pod dolním okrajem VisualElement.
• Right – označuje, že se popis přístupového klíče zobrazí napravo od pravého VisualElementokraje .
• Left – označuje, že se popis přístupového klíče zobrazí vlevo od levého VisualElementokraje .
• Center – označuje, že se popis přístupového klíče zobrazí nad středem VisualElement.

Poznámka:

Umístění tipu Auto klíče je obvykle dostatečné, což zahrnuje podporu adaptivních uživatelských rozhraní.

Metody VisualElement.SetAccessKeyHorizontalOffset a VisualElement.SetAccessKeyVerticalOffset metody lze použít k podrobnějšímu řízení umístění tipu přístupového klíče. Argument metody SetAccessKeyHorizontalOffset označuje, jak daleko přesunout přístupový klíč doleva nebo doprava, a argument metody SetAccessKeyVerticalOffset označuje, jak daleko přesunout přístupový klíč nahoru nebo dolů.

Poznámka:

Posuny tipu přístupového klíče nelze nastavit při nastavení Autoumístění přístupového klíče .

Kromě toho lze použít , GetAccessKeyGetAccessKeyPlacementGetAccessKeyHorizontalOffset, a GetAccessKeyVerticalOffset metody k načtení hodnoty přístupového klíče a jeho umístění.

Výsledkem je, že se tipy pro přístupové klávesy dají zobrazit vedle všech VisualElement instancí, které definují přístupové klávesy, stisknutím klávesy Alt:

Když uživatel aktivuje přístupovou klávesu, stisknete klávesu Alt a potom přístupový klíč, spustí se výchozí akce pro tuto VisualElement akci. Například když uživatel aktivuje přístupový klíč na přepínačiSwitchSwitch. Když uživatel aktivuje přístupový klíč na objektu Entry, Entry získá fokus. Když uživatel aktivuje přístupový klíč na Button, obslužná rutina události pro Clicked událost se spustí.

Další informace o přístupových klíčích najdete v tématu Přístupové klíče.