KeyboardShortcut kontrola

Artykuł
03/21/2023

Formant używany do przechwytywania i kontrolowania zdarzeń klawiaturowych.

Uwaga

Pełna dokumentacja i kod źródłowy znajdują się w repozytorium GitHub komponentów kodu.

opis

Ten składnik kodu rejestruje programy obsługi zdarzeń naciśnięcia klawisza, aby umożliwić używanie skrótów klawiaturowych w aplikacjach kanwy lub na stronach niestandardowych. Nie jest przeznaczony do użycia w aplikacjach opartych na modelach ani w aplikacjach portalu.

Właściwości

Właściwości	opis
`KeyConfig`	Tablica ciągów wskazująca, jakich skrótów klawiaturowych należy nasłuchiwać. Ciąg musi zostać seryjny przy użyciu JSON (przykład podany w następnej sekcji).
`OnKey`	Skrót klawiszowy, który został wykryty.

Po dodaniu do formularza komponentu kodu KeyboardShortcuts skonfiguruj właściwość KeyConfig z tablicą kombinacji klawiszy.

Na przykład:

["alt + r","alt + a","alt + d","alt + b","alt + p","alt + l","alt + t","alt + k"]

Więcej informacji na temat ciągów połączenia klawiatury można znaleźć w bibliotece KeyboardJS.

Zachowanie

Odpowiadanie na zdarzenia klawisza

W przypadku kombinacji klawiszy zdarzenie OnChange jest wywoływane. Właściwość OnKey zawiera następnie kombinację.

Może mieć miejsce zdarzenie OnChange podobne do:

If( Self.OnKey = "alt + a",
    SetFocus(txtTextbox1)
);
If( Self.OnKey = "alt + r",
    UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + b",
    SetFocus(txtTextbox2)
);
If( Self.OnKey = "alt + k",
    UpdateContext({ ctxPickerEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + d",
    UpdateContext({ ctxDropdownEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + l",
    UpdateContext({ ctxTagListEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + t", 
    UpdateContext({ ctxTableEvent:"SetFocusOnRow" & Text(Rand()) })
);

Program obsługi tego zdarzenia pozwala koncentrować się na różnych kontrolkach z uwzględnieniem używanej kombinacji kluczy.

Ograniczenia

Niektóre skróty klawiaturowe są używane przez Power Apps Studio podczas edycji aplikacji, a niektóre są używane przez przeglądarkę. Z tego powodu ten składnik nie będzie działał we wszystkich skrótach klawiaturowych, dopóki użytkownik nie zostanie skupienie w aplikacji.

Tego składnika kodu można używać tylko w aplikacjach kanwy i na stronach niestandardowych.

Zobacz więcej uwag dotyczących ograniczeń w sekcji Wyzwania związane z projektowaniem składników w dokumentacji usługi GitHub.

Udostępnij za pośrednictwem