KeyboardAccelerator Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Tastenkombination (oder Zugriffstaste) dar, mit der ein Benutzer eine Aktion mithilfe der Tastatur ausführen kann, anstatt durch die App-UI zu navigieren (direkt oder über Zugriffstasten).
Zugriffstasten werden in der Regel Schaltflächen oder Menüelementen zugewiesen.
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyboardAccelerator : DependencyObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class KeyboardAccelerator : DependencyObjectPublic Class KeyboardAccelerator
Inherits DependencyObject- Vererbung
- Attribute
Hinweise
Eine Tastenkombination kann eine einzelne Taste sein, z. B. F1 - F12 und ESC, oder eine Kombination aus Tasten (STRG+ UMSCHALT+ B oder STRG C), die einen Befehl aufrufen. Sie unterscheiden sich von Zugriffstasten (Mnemonics), die in der Regel mit der ALT-TASTE geändert werden und einfach einen Befehl oder ein Steuerelement aktivieren.
Eine Zugriffstaste kann auch dann ausgeführt werden, wenn das element, das der Zugriffstaste zugeordnet ist, nicht sichtbar ist. Beispielsweise kann ein Element in der SecondaryCommands-Auflistung der CommandBar mithilfe einer Zugriffstaste aufgerufen werden, ohne das Überlaufmenü zu erweitern und das Element anzuzeigen.
Standardmäßig verfügt eine Zugriffstaste über einen globalen Bereich. Sie können den Bereich jedoch mithilfe von ScopeOwner einschränken oder eine Zugriffstaste vollständig mithilfe von IsEnabled deaktivieren.
Konstruktoren
| Name | Beschreibung |
|---|---|
| KeyboardAccelerator() |
Initialisiert eine neue Instanz der KeyboardAccelerator-Klasse . |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| IsEnabled |
Ruft ab oder legt fest, ob eine Tastenkombination (Zugriffstaste) für den Benutzer verfügbar ist. |
| IsEnabledProperty |
Identifies the IsEnabled dependency property. |
| Key |
Dient zum Abrufen oder Festlegen der virtuellen Taste (in Verbindung mit einer oder mehreren Modifizierertasten) für eine Tastenkombination (Tastenkombination). Eine Tastenkombination wird aufgerufen, wenn die Modifizierertasten, die der Tastenkombination zugeordnet sind, gedrückt werden und die Nichtmodifizierertaste gleichzeitig gedrückt wird. Beispiel: STRG+C zum Kopieren und STRG+S zum Speichern. |
| KeyProperty |
Identifies the Key dependency property. |
| Modifiers |
Ruft die virtuelle Taste ab, die zum Ändern einer anderen Tastenkombination (Tastenkombination) verwendet wird, oder legt sie fest. Eine Tastenkombination wird aufgerufen, wenn die Modifizierertasten, die der Tastenkombination zugeordnet sind, gedrückt werden und die Nichtmodifizierertaste gleichzeitig gedrückt wird. Beispiel: STRG+C zum Kopieren und STRG+S zum Speichern. |
| ModifiersProperty |
Identifies the Modifiers dependency property. |
| ScopeOwner |
Ruft den Bereich (oder das Ziel) der Zugriffstaste ab oder legt diesen fest. |
| ScopeOwnerProperty |
Identifies the ScopeOwner dependency property. |
Methoden
| Name | Beschreibung |
|---|---|
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Invoked |
Tritt auf, wenn die Tastenkombination für diesen KeyboardAccelerator gedrückt wird. |