Ovládací prvek KeyboardShortcut

Článek
03/21/2023

Ovládací prvek používaný k zachycení událostí klávesnice a jejich ovládání.

Poznámka:

Úplná dokumentace a zdrojový kód jsou k dispozici v úložišti komponent kódu GitHubu.

Description

Tato komponenta kódu registruje obslužné rutiny události stisknutí klávesy, aby bylo možné používat klávesové zkratky v aplikacích plátna nebo vlastních stránkách. Není určena k použití v modelem řízených nebo portálových aplikacích.

Vlastnosti

Vlastnost	Description
`KeyConfig`	Pole řetězců udávajících, které klávesové zkratky je třeba očekávat. Řetězec musí být serializován pomocí JSON (příklad je uveden v následující části).
`OnKey`	Klávesová zkratka, která byla zjištěna.

Po přidání komponenty kódu KeyboardShortcuts do formuláře vložte do vlastnosti KeyConfig pole kombinací kláves.

Příklad:

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

Další informace o řetězcích kombinací kláves najdete v knihovně KeyboardJS.

Chování

Reakce na události stisku kláves

Když je použita kombinace kláves, je vyvolána událost OnChange. Vlastnost OnKey pak obsahuje kombinaci.

Událost OnChange může vypadat třeba takto:

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()) })
);

Tato obslužná rutina události nastaví zaměření na různé ovládací prvky dané použitou kombinací kláves.

Omezení

Některé klávesové zkratky se používají Power Apps Studio při úpravě aplikace, některé jiné používá prohlížeč. Z tohoto důvodu tato komponenta neumí zpracovat všechny klávesové zkratky, dokud uživatel nezaměří aplikaci.

Tuto komponentu kódu lze použít pouze v aplikacích plátna a vlastních stránkách.

Další poznámky k omezením naleznete v části designové výzvy komponent dokumentace GitHubu.

Share via