KeyBinding KeyBinding KeyBinding KeyBinding Class

Definition

Bindet eine KeyGesture an einen RoutedCommand (oder eine andere ICommand-Implementierung).Binds a KeyGesture to a RoutedCommand (or another ICommand implementation).

public ref class KeyBinding : System::Windows::Input::InputBinding
public class KeyBinding : System.Windows.Input.InputBinding
type KeyBinding = class
    inherit InputBinding
Public Class KeyBinding
Inherits InputBinding
Vererbung

Beispiele

Das folgende Beispiel erstellt eine KeyBinding und fügt es der InputBindingCollection im Stamm-Fenster.The following example creates a KeyBinding and adds it to the InputBindingCollection of the root window.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>
// Creating a KeyBinding between the Open command and Ctrl-R
KeyBinding OpenCmdKeyBinding = new KeyBinding(
    ApplicationCommands.Open, 
    Key.R, 
    ModifierKeys.Control);

this.InputBindings.Add(OpenCmdKeyBinding);
' Creating a KeyBinding between the Open command and Ctrl-R
Dim OpenCmdKeyBinding As New KeyBinding(ApplicationCommands.Open, Key.R, ModifierKeys.Control)

Me.InputBindings.Add(OpenCmdKeyBinding)

Hinweise

Ein KeyBinding ordnet eine KeyGesture mit einem ICommand, z. B. eine RoutedCommand.A KeyBinding associates a KeyGesture with a ICommand, such as a RoutedCommand. RoutedCommand ist die primäre Implementierung von der ICommand eine Schnittstelle für die WPFWPF -Befehlssystem.RoutedCommand is the primary implementation of the ICommand interface for the WPFWPF commanding system . Allgemein, wenn die KeyGesture ausgeführt wird der Befehl aufgerufen wird, obwohl das Verhalten des Befehls, wie z. B. Weitere durch befehlsspezifischen Faktoren beeinflusst wird die CanExecute Wert.In general, when the KeyGesture is executed the command is invoked, although the command behavior is further influenced by command-specific factors such as the CanExecute value. Weitere Informationen über Befehle finden Sie unter den Befehlsübersicht.For more information on commanding, see the Commanding Overview.

Mit Ausnahme der Funktionstasten und Zehnertastatur Schlüssel, ein gültiger KeyGesture muss genau einen enthalten Key und einem oder mehreren ModifierKeys.With the exception of the function keys and the numeric keypad keys, a valid KeyGesture must contain exactly one Key and one or more ModifierKeys. Funktionstasten und Zehnertastatur erfordern keine Modifizierertaste um eine gültige KeyGesture.Function keys and numeric keypad keys do not require a modifier key in order to be a valid KeyGesture. Es ist möglich, geben Sie einen ungültigen KeyGesture und KeyBinding mit einem ungültigen zugeordneten Taste über XAMLXAML oder Code.It is possible to specify an invalid KeyGesture and a KeyBinding with an invalid associated gesture, either through XAMLXAML or code. Beispielsweise wird nicht überprüft, die verhindert, erstellen und binden ein KeyGesture , die nur eine Funktionstaste, oder nur Modifizierer und keinen Schlüssel enthält.For instance, there is no validation that prevents creating and binding a KeyGesture that contains only a nonfunction key, or only modifiers but no key. Solche eine KeyBinding versucht nie, den zugehörigen Befehl aufzurufen.Such a KeyBinding will never attempt to invoke its associated command.

Beim Definieren einer KeyBinding in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) es gibt zwei Möglichkeiten zum Angeben der KeyGesture.When defining a KeyBinding in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) there are two ways to specify the KeyGesture. Die erste Möglichkeit zum Herstellen einer KeyBinding in XAMLXAML besteht darin, definieren die Gesture Attribut der KeyBinding -Element, das eine Syntax zum Angeben von Schlüsseln und -Modifizierern als einzelne Zeichenfolge, z. B. "STRG + P" kann.The first way to establish a KeyBinding in XAMLXAML is to define the Gesture attribute of the KeyBinding element, which enables a syntax to specify keys and modifiers as a single string, for example "CTRL+P". Die zweite Möglichkeit besteht darin, definieren die Key Attribut und die Modifiers Attribute der KeyBinding Element.The second way is to define the Key attribute and the Modifiers attributes of the KeyBinding element. Beide Methoden zum Festlegen der KeyGesture sind äquivalent und die gleiche zugrunde liegende Objekt ändern, aber ein Konflikt, wenn beide verwendet werden.Both ways of setting the KeyGesture are equivalent and modify the same underlying object, but there will be a conflict if both are used. In die Groß-/Kleinschreibung bei der Key, Modifiers, und die Gesture Attribute festgelegt sind, wird das Attribut, das definiert, wird zuletzt verwendet für die KeyGesture.In the case when the Key, Modifiers, and the Gesture attributes are all set, the attribute which is defined last will be used for the KeyGesture. Sie können möglicherweise auch vorkommen, z. B. eine Key Satz zuletzt wird jedoch nur die Schlüssel einer vorherigen Eingabeaktion überschrieben, ohne die entsprechenden Modifizierer identisch.You can potentially have situations where for example a Key set last will overwrite just the Key component of a preceding Gesture but leave the Gesture's modifiers the same. Im Allgemeinen wird empfohlen, dass Sie nur verwenden, die Gesture -Attribut vom XAMLXAML; Dies wird Mehrdeutigkeit vermieden, stellt die geradlinigste Syntax bereit und bietet die einfachste Darstellung für die Serialisierung.In general, it is recommended that you use only the Gesture attribute from XAMLXAML; this will avoid ambiguity, provides the most streamlined syntax, and provides the most straightforward representation for serialization.

Ein KeyBinding kann auf ein bestimmtes Objekt oder auf Klassenebene definiert werden, durch die Registrierung einer RegisterClassInputBinding auf die CommandManager Klasse.A KeyBinding can be defined on a specific object or at the class level by registering a RegisterClassInputBinding on the CommandManager class. Der häufigste Auslöser zum Definieren einer KeyBinding befindet sich innerhalb der Steuerelementvorlage, indem die InputBindings -Eigenschaft in XAMLXAML durch deklarieren eine oder mehrere MouseBinding oder KeyBinding Elemente.The most typical way to define a KeyBinding is within the control template, setting the InputBindings property in XAMLXAML by declaring one or more MouseBinding or KeyBinding elements.

Konstruktoren

KeyBinding() KeyBinding() KeyBinding() KeyBinding()

Initialisiert eine neue Instanz der KeyBinding-Klasse.Initializes a new instance of the KeyBinding class.

KeyBinding(ICommand, Key, ModifierKeys) KeyBinding(ICommand, Key, ModifierKeys) KeyBinding(ICommand, Key, ModifierKeys) KeyBinding(ICommand, Key, ModifierKeys)

Initialisiert eine neue Instanz der KeyBinding-Klasse mit dem angegebenen ICommand und der angegebenen Key sowie ModifierKeys, die in eine KeyGesture konvertiert werden.Initializes a new instance of the KeyBinding class using the specified ICommand and the specified Key and ModifierKeys which will be converted into a KeyGesture.

KeyBinding(ICommand, KeyGesture) KeyBinding(ICommand, KeyGesture) KeyBinding(ICommand, KeyGesture) KeyBinding(ICommand, KeyGesture)

Initialisiert eine neue Instanz der KeyBinding-Klasse unter Verwendung der angegebenen ICommand und des angegebenen KeyGesture.Initializes a new instance of the KeyBinding class using the specified ICommand and KeyGesture.

Felder

KeyProperty KeyProperty KeyProperty KeyProperty

Identifiziert die Key-Abhängigkeitseigenschaft.Identifies the Key dependency property.

ModifiersProperty ModifiersProperty ModifiersProperty ModifiersProperty

Identifiziert die Modifiers-Abhängigkeitseigenschaft.Identifies the Modifiers dependency property.

Eigenschaften

Command Command Command Command

Ruft die dieser Eingabebindung zugeordnete ICommand-Klasse ab oder legt diese fest.Gets or sets the ICommand associated with this input binding.

(Inherited from InputBinding)
CommandParameter CommandParameter CommandParameter CommandParameter

Übernimmt oder bestimmt die befehlsspezifischen Daten für einen bestimmten Befehl.Gets or sets the command-specific data for a particular command.

(Inherited from InputBinding)
CommandTarget CommandTarget CommandTarget CommandTarget

Übernimmt oder bestimmt das Zielelement des Befehls.Gets or sets the target element of the command.

(Inherited from InputBinding)
DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Gesture Gesture Gesture Gesture

Ruft die dieser Eingabeaktion zugeordnete KeyBinding ab oder legt diese fest.Gets or sets the gesture associated with this KeyBinding.

IsSealed IsSealed IsSealed IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Key Key Key Key

Ruft die Key der KeyGesture ab, die mit dieser KeyBinding verknüpft ist oder legt diese fest.Gets or sets the Key of the KeyGesture associated with this KeyBinding.

Modifiers Modifiers Modifiers Modifiers

Ruft die ModifierKeys der KeyGesture ab, die mit dieser KeyBinding verknüpft ist oder legt diese fest.Gets or sets the ModifierKeys of the KeyGesture associated with this KeyBinding.

Methoden

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Bestimmt, ob der aufrufende Thread den Zugriff auf diese kann DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable)

Kopiert die Basiswerte (nicht animiert) die Eigenschaften des angegebenen Objekts.Copies the base (non-animated) values of the properties of the specified object.

(Inherited from InputBinding)
CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable)

Kopiert die aktuellen Werte der Eigenschaften des angegebenen Objekts.Copies the current values of the properties of the specified object.

(Inherited from InputBinding)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CreateInstanceCore() CreateInstanceCore() CreateInstanceCore() CreateInstanceCore()

Erstellt eine Instanz eines KeyBinding.Creates an instance of a KeyBinding.

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

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable)

Definiert die Instanz als fixierten Klon des angegebenen Freezable mithilfe von Basiseigenschaftswerten (nicht animiert).Makes the instance a frozen clone of the specified Freezable by using base (non-animated) property values.

(Inherited from InputBinding)
GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable)

Macht diese aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable-Objekts.Makes the current instance a frozen clone of the specified Freezable. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert.If the object has animated dependency properties, their current animated values are copied.

(Inherited from InputBinding)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Ruft einen Hashcode für diesen DependencyObject ab.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Berechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neuRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Die spezifische Abhängigkeitseigenschaft, die sich geändert hat, wird in den Ereignisdaten angegeben.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
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)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Erzwingt, dass der aufrufende Thread den Zugriff auf diese DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Gilt für:

Siehe auch