KeyBinding Klasse

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

Im folgenden Beispiel wird ein KeyBinding erstellt und dem InputBindingCollection des Stamm Fensters hinzugefügt.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 KeyBindingordnet einen einem ICommandzu, z RoutedCommand. b. KeyGestureA KeyBinding associates a KeyGesture with a ICommand, such as a RoutedCommand. RoutedCommandist die primäre Implementierung der ICommand -Schnittstelle für das WPFWPF Befehlssystem.RoutedCommand is the primary implementation of the ICommand interface for the WPFWPF commanding system . Im Allgemeinen wird beim KeyGesture Ausführen von der Befehl aufgerufen, obwohl das Befehls Verhalten weiter von Befehls spezifischen Faktoren wie dem CanExecute Wert beeinflusst wird.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 zu den Befehls Informationen finden Sie in der Befehls Übersicht.For more information on commanding, see the Commanding Overview.

Mit Ausnahme der Funktionstasten und der numerischen Tastatur-Schlüssel muss ein gültiger KeyGesture genau einen Key und ModifierKeysmindestens einen enthalten.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. Für Funktionstasten und numerische Tastatur-Schlüssel ist keine Modifizierertaste erforderlich, damit Sie gültig KeyGestureist.Function keys and numeric keypad keys do not require a modifier key in order to be a valid KeyGesture. Es ist möglich, einen ungültigen KeyGesture und einen KeyBinding mit einer ungültigen zugeordneten Geste anzugeben XAMLXAML , entweder über oder Code.It is possible to specify an invalid KeyGesture and a KeyBinding with an invalid associated gesture, either through XAMLXAML or code. Beispielsweise gibt es keine Validierung, die das Erstellen und Binden eines KeyGesture verhindert, das nur einen nicht Funktionsschlüssel oder nur Modifizierers, aber 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. Ein KeyBinding solcher Versuch wird nie versuchen, den zugehörigen Befehl aufzurufen.Such a KeyBinding will never attempt to invoke its associated command.

Beim definieren KeyBinding von in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) gibt es zwei Möglichkeiten, das KeyGestureanzugeben.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 Einrichten eines KeyBinding in XAMLXAML besteht darin, das Gesture -Attribut des KeyBinding -Elements zu definieren, das eine Syntax ermöglicht, um Schlüssel und Modifizierer als einzelne Zeichenfolge anzugeben, z. b. "STRG + P".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, das Key -Attribut und Modifiers die Attribute des KeyBinding -Elements zu definieren.The second way is to define the Key attribute and the Modifiers attributes of the KeyBinding element. Beide Methoden zum Festlegen KeyGesture von sind gleichwertig und ändern dasselbe zugrunde liegende Objekt, aber es tritt ein Konflikt auf, wenn beides verwendet wird.Both ways of setting the KeyGesture are equivalent and modify the same underlying object, but there will be a conflict if both are used. Wenn die Key-, Modifiers-und- Gesture Attribute alle festgelegt sind, wird das-Attribut, das zuletzt definiert ist, für das KeyGestureverwendet.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. Möglicherweise gibt es Situationen, in denen z Key . b. ein Satz zuletzt nur die Schlüsselkomponente einer vorangehenden Geste überschreibt, aber die Modifizierers der Geste unverändert lassen.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 das Gesture -Attribut aus XAMLXAMLverwenden. Dadurch wird Mehrdeutigkeit vermieden, die optimierte Syntax bereitstellt und die einfachste Darstellung der Serialisierung bereitstellt.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 -Objekt kann für ein bestimmtes-Objekt oder auf Klassenebene definiert werden, RegisterClassInputBinding indem ein CommandManager für die-Klasse registriert wird.A KeyBinding can be defined on a specific object or at the class level by registering a RegisterClassInputBinding on the CommandManager class. Die typische KeyBinding Methode zum Definieren eines ist innerhalb der Steuerelement Vorlage, indem die InputBindings -Eigenschaft in XAMLXAML festgelegt wird, indem KeyBinding ein oder mehrere MouseBinding -oder-Elemente deklariert werden.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()

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

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)

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

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

ModifiersProperty

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

Eigenschaften

CanFreeze

Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann.Gets a value that indicates whether the object can be made unmodifiable.

(Geerbt von Freezable)
Command

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

(Geerbt von InputBinding)
CommandParameter

Ruft die befehlsspezifischen Daten für einen bestimmten Befehl ab oder legt diese fest.Gets or sets the command-specific data for a particular command.

(Geerbt von InputBinding)
CommandTarget

Ruft das Zielelement des Befehls ab oder legt dieses fest.Gets or sets the target element of the command.

(Geerbt von InputBinding)
DependencyObjectType

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

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
Gesture

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

IsFrozen

Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann.Gets a value that indicates whether the object is currently modifiable.

(Geerbt von Freezable)
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).

(Geerbt von DependencyObject)
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

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()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
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.

(Geerbt von DependencyObject)
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.

(Geerbt von DependencyObject)
Clone()

Erstellt einen änderbaren Klon des Freezable-Objekts, indem tiefe Kopien der Werte des Objekts erstellt werden.Creates a modifiable clone of the Freezable, making deep copies of the object's values. Beim Kopieren der Abhängigkeitseigenschaften des Objekts kopiert diese Methode Ausdrücke (die möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Geerbt von Freezable)
CloneCore(Freezable)

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

(Geerbt von InputBinding)
CloneCurrentValue()

Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten.Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Geerbt von Freezable)
CloneCurrentValueCore(Freezable)

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

(Geerbt von InputBinding)
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.

(Geerbt von DependencyObject)
CreateInstance()

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

(Geerbt von Freezable)
CreateInstanceCore()

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

Equals(Object)

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

(Geerbt von DependencyObject)
Freeze()

Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Geerbt von Freezable)
FreezeCore(Boolean)

Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann.Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Geerbt von Freezable)
GetAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert).Creates a frozen copy of the Freezable, using base (non-animated) property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetAsFrozenCore(Freezable)

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

(Geerbt von InputBinding)
GetCurrentValueAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten.Creates a frozen copy of the Freezable using current property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von 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.

(Geerbt von InputBinding)
GetHashCode()

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

(Geerbt von DependencyObject)
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.

(Geerbt von DependencyObject)
GetType()

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

(Geerbt von Object)
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.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

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

(Geerbt von Object)
OnChanged()

Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird.Called when the current Freezable object is modified.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Dieser Member unterstützt die Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Geerbt von Freezable)
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. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)

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

(Geerbt von DependencyObject)
ReadPreamble()

Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird.Ensures that the Freezable is being accessed from a valid thread. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)

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

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

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

(Geerbt von DependencyObject)
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.

(Geerbt von DependencyObject)
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.

(Geerbt von DependencyObject)
ToString()

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

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
WritePostscript()

Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf.Raises the Changed event for the Freezable and invokes its OnChanged() method. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Geerbt von Freezable)
WritePreamble()

Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Geerbt von Freezable)

Ereignisse

Changed

Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird.Occurs when the Freezable or an object it contains is modified.

(Geerbt von Freezable)

Gilt für:

Siehe auch