KeyboardShortcut kontrol

Artikel
03/21/2023

Et kontrolelement, der bruges til at registrere og handle på tastaturhændelser.

Bemærk

Fuld dokumentation og kildekode fundet i GitHub-kodekomponenters lager.

Beskrivelse

Denne kodekomponent registrerer tastetrykhændelseshandlere, så der kan bruges tastaturgenveje i lærredapps eller på brugerdefinerede sider. Den er ikke beregnet til brug i modelbaserede apps eller portalapps.

Egenskaber

Egenskab	Beskrivelse
`KeyConfig`	En matrix af strenge, der angiver, hvilke tastaturgenveje der skal lyttes efter. Strengen skal være serialiseret ved hjælp af JSON (eksempel givet i følgende afsnit).
`OnKey`	Den tastekode for genvej, der blev registreret.

Når du har føjet KeyboardShortcuts-kodekomponenten til formularen, skal du konfigurere egenskaben KeyConfig med en matrix med nøglekombinationer.

Eksempel:

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

Du kan finde flere oplysninger om kombinationsstrenge på tastaturet i KeyboardJS-biblioteket.

Adfærd

Sådan reagerer du på de tastetrykhændelser

Når der bruges en tastekombination, udløses hændelsen OnChange. Egenskaben OnKey indeholder derefter en kombination.

Du kan have en OnChange-hændelse, der minder om følgende:

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

Denne hændelseshandler skifter fokus til forskellige kontrolelementer, afhængigt af den anvendte tastekombination.

Begrænsninger

Nogle tastaturgenveje bruges af Power Apps Studio, når du redigerer appen, og nogle bruges af browseren. Denne komponent fungerer derfor først for alle tastaturgenveje, når brugeren skifter fokus til appen.

Denne kodekomponent kan kun bruges i lærredapps og brugerdefinerede sider.

Se flere begrænsningsnoter i afsnittet komponentdesignudfordringer i dokumentationen til GitHub.

Del via