KeyboardShortcut kontroll

Artikel
03/21/2023

En kontroll som används för att läsa in och agera på tangentbordshändelser.

Kommentar

Fullständig dokumentation och källkod finns i lagringsplatsen för GitHub-kodkomponenter.

Description

Den här kodkomponenten registrerar händelsehanterare för tangenttryckningar i syfte att tillåta att kortkommandon används i arbetsyteappar eller på anpassade sidor. Den är inte tänkt att användas i modellbaserade program eller portalappar.

Egenskaper

Property	Description
`KeyConfig`	En matris med strängar som anger vilka kortkommandon som ska lyssnas på. Strängen måste serialiseras med hjälp av JSON (exempel ges i följande avsnitt).
`OnKey`	Kortkommandot som identifierades.

När du har lagt till KeyboardShortcuts-kodkomponenten i formuläret konfigurerar du KeyConfig-egenskapen med en matris med nyckelkombinationer.

Till exempel:

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

Mer information om kombinationssträngar för tangentbord finns i KeyboardJS-biblioteket.

Funktionssätt

Svara på knapptryckhändelser

När en tangentkombination används utlöses OnChange-händelsen. Egenskapen OnKey innehåller sedan kombinationen.

Du kanske får en OnChange-händelse liknande följande:

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

Händelsehanteraren fokuserar på olika kontroller baserat på den tangentkombination som används.

Begränsningar

Vissa kortkommandon används av Power Apps Studio när du redigerar programmet, medan vissa används av webbläsaren. Därför fungerar inte den här komponenten för alla kortkommandon förrän användaren fokuserar på programmet.

Den här kodkomponenten kan endast användas i arbetsyteappar och anpassade sidor.

Se mer begränsningsanteckningar i avsnittet om komponent designutmaningar i dokumentationen GitHub.

Dela via