KeyGesture Klasse

Referenz

Definition

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

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.

Definiert eine Tastenkombination, die verwendet werden kann, um einen Befehl aufzurufen.

public ref class KeyGesture : System::Windows::Input::InputGesture

[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))>]
type KeyGesture = class
    inherit InputGesture

Public Class KeyGesture
Inherits InputGesture

Vererbung: Object

InputGesture
KeyGesture

Attribute: TypeConverterAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie den Close Befehl mithilfe von an bindenKeyBinding KeyGesture.

KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

KeyBinding CloseKeyBinding = new KeyBinding(
    ApplicationCommands.Close, CloseCmdKeyGesture);

this.InputBindings.Add(CloseKeyBinding);

Dim CloseCmdKeyGesture As New KeyGesture(Key.L, ModifierKeys.Alt)

Dim CloseKeyBinding As New KeyBinding(ApplicationCommands.Close, CloseCmdKeyGesture)

Me.InputBindings.Add(CloseKeyBinding)

Das folgende Beispiel zeigt die Verwendung KeyGesture in XAML. Beachten Sie, dass die XAML-Verwendung ein <KeyGesture> Element nicht direkt deklarieren wird. Die Verwendung dieses Objektelements ist nicht möglich, da KeyGesture kein öffentlicher parameterloser Konstruktor verfügbar gemacht wird. Stattdessen verwendet die XAML-Verwendung das Typeconverter-Verhalten, um eine gesamte KeyGesture Inline als Gesture Attributwert zu deklarieren.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>

Hinweise

In den meisten Fällen muss einer KeyGesture oder ModifierKeysmehreren zugeordnet sein. Die Ausnahmen von dieser Regel sind die Funktionstasten und die numerischen Tastenkombinationen, die für sich selbst gültig KeyGesture sein können. Beispielsweise können Sie einen KeyGesture erstellen, indem Sie nur die F12-Taste verwenden, aber um die X-Taste in einem KeyGesture zu verwenden, muss sie mit einer Modifizierertaste gekoppelt werden.

Sie können ein KeyBinding verwenden, um ein KeyGesture an zu ICommandbinden, sodass der Befehl aufgerufen wird, wenn der KeyGesture auftritt.

Bei KeyGesture XAML-Verwendungen ist die Eigenschaft, die in XAML im Allgemeinen festgelegt wird Gesture, in Fällen, in denen die Geste sowohl einen Standardschlüssel als auch einen Modifiziererschlüssel darstellt. Sie können auch festlegen, dass die Gesture Eigenschaft nur eine Funktionstaste oder nur eine Kombination aus Modifizierertasten ist. Es ist jedoch üblicher, die Key -Eigenschaft festzulegen, wenn es sich bei der beabsichtigten Befehlsbindung um einen Funktionsschlüssel ohne Modifizierer handelt oder Modifiers wenn die beabsichtigte Befehlsbindung nur für Modifiziererschlüssel gilt.

Verwendung von XAML-Attributen

<object property="oneOrMoreModifierKeys+key"/>  
- or -  
<object property="functionKey"/>

XAML-Werte

functionKey
Key

Ein einzelner Schlüsselwert, der eine der Funktionstasten (F1-12) oder numerische Tastenkombinationen sein muss.

oneOrMoreModifierKeys
Ein oder mehrere Modifizierertasten, die durch die ModifierKeys Enumeration definiert sind und mit einem "+"-Zeichen getrennt sind.

key
Key

Ein einzelner Schlüsselwert.

Konstruktoren

KeyGesture(Key)	Initialisiert eine neue Instanz der KeyGesture-Klasse mit der angegebenen Key.
KeyGesture(Key, ModifierKeys)	Initialisiert eine neue Instanz der KeyGesture-Klasse mit den angegebenen Key und dem angegebenen ModifierKeys.
KeyGesture(Key, ModifierKeys, String)	Initialisiert eine neue Instanz der KeyGesture-Klasse mit der angegebenen Key, ModifierKeys und der Anzeigezeichenfolge.

Eigenschaften

DisplayString	Ruft eine Zeichenfolgendarstellung dieser KeyGesture ab.
Key	Ruft die Taste ab, die dieser KeyGesture zugeordnet ist.
Modifiers	Ruft die dieser KeyGesture zugeordneten Modifizierertasten ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetDisplayStringForCulture(CultureInfo)	Gibt eine Zeichenfolge zurück, die verwendet werden kann, um die KeyGesture anzuzeigen.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Matches(Object, InputEventArgs)	Bestimmt, ob diese KeyGesture der Eingabe entspricht, die dem angegebenen InputEventArgs-Objekt zugeordnet ist.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: