KeyGesture KeyGesture KeyGesture KeyGesture Class

Definition

Definiert eine Tastenkombination, die verwendet werden kann, um einen Befehl aufzurufen.Defines a keyboard combination that can be used to invoke a command.

public ref class KeyGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture
type KeyGesture = class
    inherit InputGesture
Public Class KeyGesture
Inherits InputGesture
Vererbung
Attribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie der Close -Befehl mithilfe KeyGesture KeyBindingvon an einen gebunden wird.The following example shows how to bind the Close command to a KeyGesture using a 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 KeyGesture in XAMLXAMLverwendet wird.The following example shows how to use KeyGesture in XAMLXAML. Beachten Sie, XAMLXAML dass die Verwendung nicht direkt ein <KeyGesture> -Element deklariert.Note that the XAMLXAML usage does not directly declare a <KeyGesture> element. Die Verwendung des Objekt Elements ist nicht möglich KeyGesture , da keinen öffentlichen Parameter losen Konstruktor verfügbar macht.That object element usage is not possible because KeyGesture does not expose a public parameterless constructor. Stattdessen verwendet die XAMLXAML Verwendung das TypeConverter-Verhalten, um eine gesamte KeyGesture Inline als Gesture Attribut Wert zu deklarieren.Instead, the XAMLXAML usage uses the typeconverter behavior to declare an entire KeyGesture inline as the Gesture attribute value.

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

Hinweise

In den meisten Fällen muss KeyGesture eine mit einer oder mehreren ModifierKeysverknüpft werden.In most cases, a KeyGesture must be associated with one or more ModifierKeys. Die Ausnahmen für diese Regel sind die Funktionsschlüssel und die numerischen Tastatur-Schlüssel, die selbst gültig KeyGesture sein können.The exceptions to this rule are the function keys and the numeric keypad keys, which can be a valid KeyGesture by themselves. Beispielsweise können Sie eine KeyGesture mit nur der Taste F12 erstellen, aber um die X-Taste in einer KeyGesture zu verwenden, muss Sie mit einer Modifizierertaste gekoppelt werden.For example, you can create a KeyGesture by using only the F12 key, but to use the X key in a KeyGesture it must be paired with a modifier key.

Im Allgemeinen können SieIn general, you can

Sie können einen verwenden KeyBinding , um einen KeyGesture an einen ICommandzu binden, sodass der Befehl aufgerufen wird, KeyGesture wenn der auftritt.You can use a KeyBinding to bind a KeyGesture to an ICommand, so that the command is invoked when the KeyGesture occurs.

Für KeyGesture XAMLXAML Verwendungen istGesturedie Eigenschaft, die in der Regel in festgelegt ist, in Fällen, in denen die Geste sowohl einen Standardschlüssel als auch eine Modifizierertaste darstellt. XAMLXAMLFor KeyGesture XAMLXAML usages, the property that is generally set in XAMLXAML is Gesture, in cases where the gesture represents both a standard key and a modifier key. Sie können auch festlegen, Gesture dass die-Eigenschaft nur eine Funktionstaste oder nur eine modifiziererschlüsselkombination ist.You can also set the Gesture property to be just a function key, or just a modifier key combination. Es ist jedoch eher üblich, die Key -Eigenschaft festzulegen, wenn die beabsichtigte Befehls Bindung ein Funktionsschlüssel ohne Modifizierer ist oder Modifiers wenn die beabsichtigte Befehls Bindung nur für modifiziererschlüssel vorgesehen ist.However, it is more common to set the Key property if the intended command binding is a function key with no modifiers, or Modifiers if the intended command binding is for modifier keys only.

Verwendung von XAML-AttributenXAML Attribute Usage

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

XAML-WerteXAML Values

functionKey
Key

Ein einzelner Schlüsselwert, bei dem es sich um einen der Funktionsschlüssel (F1-12) oder um numerische Tastatur-Schlüssel handeln muss.A single key value, which must be one of the function keys (F1-12) or numeric keypad keys.

oneOrMoreModifierKeys
Ein oder mehrere Modifizierertasten, die durch ModifierKeys die-Enumeration definiert sind, sind durch ein "+"-Zeichen getrennt.One or more modifier keys, defined by the ModifierKeys enumeration, delimited with a "+" character.

key
Key

Ein einzelner Schlüsselwert.A single key value.

Konstruktoren

KeyGesture(Key) KeyGesture(Key) KeyGesture(Key) KeyGesture(Key)

Initialisiert eine neue Instanz der KeyGesture-Klasse mit der angegebenen Key.Initializes a new instance of the KeyGesture class with the specified Key.

KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys)

Initialisiert eine neue Instanz der KeyGesture-Klasse mit den angegebenen Key und dem angegebenen ModifierKeys.Initializes a new instance of the KeyGesture class with the specified Key and ModifierKeys.

KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String)

Initialisiert eine neue Instanz der KeyGesture-Klasse mit der angegebenen Key, ModifierKeys und der Anzeigezeichenfolge.Initializes a new instance of the KeyGesture class with the specified Key, ModifierKeys, and display string.

Eigenschaften

DisplayString DisplayString DisplayString DisplayString

Ruft eine Zeichenfolgendarstellung dieser KeyGesture ab.Gets a string representation of this KeyGesture.

Key Key Key Key

Ruft die Taste ab, die dieser KeyGesture zugeordnet ist.Gets the key associated with this KeyGesture.

Modifiers Modifiers Modifiers Modifiers

Ruft die dieser KeyGesture zugeordneten Modifizierertasten ab.Gets the modifier keys associated with this KeyGesture.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo)

Gibt eine Zeichenfolge zurück, die verwendet werden kann, um die KeyGesture anzuzeigen.Returns a string that can be used to display the KeyGesture.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Matches(Object, InputEventArgs) Matches(Object, InputEventArgs) Matches(Object, InputEventArgs) Matches(Object, InputEventArgs)

Bestimmt, ob diese KeyGesture der Eingabe entspricht, die dem angegebenen InputEventArgs-Objekt zugeordnet ist.Determines whether this KeyGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch