Freigeben über


KeyboardShortcut Kontrolle

Ein Steuerelement zum Aufzeichnen und Bearbeiten von Tastaturereignissen.

Notiz

Sie finden die vollständige Dokumentation und den Quellcode im GitHub-Codekomponenten-Repository.

Beschreibung des Dataflows

Diese Codekomponente registriert Tastendruckereignisse um die Verwendung von Tastaturkürzeln in Canvas-Apps und auf benutzerdefinierten Seiten zu ermöglichen. Es ist nicht für die Verwendung in Modellgesteuerten oder Portal-Apps vorgesehen.

Eigenschaften

Eigenschaften Beschreibung des Dataflows
KeyConfig Ein Array von Zeichenfolgen, das angibt, auf welche Tastaturkürzel geachtet werden soll. Die Zeichenfolge muss mithilfe von JSON serialisiert werden (Beispiel im folgenden Abschnitt).
OnKey Der Tastenkombination, die erkannt wurde.

Nach dem Hinzufügen der KeyboardShortcuts-Codekomponente zum Formular, konfigurieren Sie die KeyConfig-Eigenschaft mit einem Array von Tastenkombinationen.

Zum Beispiel:

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

Weitere Informationen zu den Zeichenfolgen für Tastaturkombinationen finden Sie in der KeyboardJS-Bibliothek.

Behavior

Reagieren auf die Tastatureingabeereignisse

Bei Verwendung einer Tastenkombination wird das OnChange Ereignis ausgelöst. Die OnKey-Eigenschaft enthält dann die Kombination.

Eventuell haben Sie ein OnChange-Ereignis, das ungefähr so aussieht:

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

Dieser Ereignishandler legt den Fokus auf verschiedene Steuerelemente, je nach verwendeter Tastenkombination.

Einschränkungen

Einige Tastenkombinationen werden von Power Apps Studio verwendet, während die App bearbeitet wird, Einige werden vom Browser verwendet. Aus diesem Grund funktioniert diese Komponente nicht für alle Tastenkombinationen, bis der Benutzer den Fokus innerhalb der App platziert.

Diese Codekomponente kann nur in Canvas-Apps und benutzerdefinierten Seiten verwendet werden.

Weitere Hinweise auf Einschränkungen finden Sie im Abschnitt Herausforderungen beim Komponentendesign der GitHub-Dokumentation.