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

Im folgenden Beispiel wird gezeigt, wie Sie den Close Befehl an eine verwendung einer KeyGesture KeyBinding.

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)

Im folgenden Beispiel wird gezeigt, wie sie in XAML verwendet werden KeyGesture . Beachten Sie, dass die XAML-Verwendung kein <KeyGesture> Element direkt deklarieren kann. 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 ein KeyGesture oder mehrere ModifierKeyszugeordnet werden. Die Ausnahmen dieser Regel sind die Funktionstasten und die numerischen Tasten, die selbst gültig KeyGesture sein können. Sie können z. B. nur KeyGesture die F12-Taste erstellen, aber um die X-Taste in einer KeyGesture taste zu verwenden, muss sie mit einer Modifizierertaste gekoppelt werden.

Im Allgemeinen können Sie

Sie können eine KeyBinding Bindung an ein KeyGesture ICommand, sodass der Befehl beim Eintreten aufgerufen KeyGesture wird.

Bei KeyGesture XAML-Verwendungen ist Gesturedie eigenschaft, die im Allgemeinen in XAML festgelegt ist, in Fällen, in denen die Geste sowohl einen Standardschlüssel als auch einen Modifiziererschlüssel darstellt. Sie können die Gesture Eigenschaft auch so festlegen, dass es sich nur um eine Funktionstaste oder nur um eine Tastenkombination handelt. Es ist jedoch häufiger, 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 Modifizierertasten 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
Mindestens eine Modifizierertaste, die durch die ModifierKeys Enumeration definiert ist, wird durch ein "+"-Zeichen getrennt.

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: