MouseBinding Klasse
Definition
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.
Bindet eine MouseGesture An eine RoutedCommand (oder eine andere ICommand Implementierung).
public ref class MouseBinding : System::Windows::Input::InputBindingpublic class MouseBinding : System.Windows.Input.InputBindingtype MouseBinding = class
inherit InputBindingPublic Class MouseBinding
Inherits InputBinding- Vererbung
- Vererbung
Beispiele
Das folgende Beispiel zeigt, wie sie eine MouseBinding Bindung MouseGesture an ein .RoutedCommand
<MouseBinding Gesture="Control+WheelClick"
Command="ApplicationCommands.Open" />
MouseGesture OpenCmdMouseGesture = new MouseGesture();
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick;
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control;
MouseBinding OpenCmdMouseBinding = new MouseBinding();
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture;
OpenCmdMouseBinding.Command = ApplicationCommands.Open;
this.InputBindings.Add(OpenCmdMouseBinding);
Dim OpenCmdMouseGesture As New MouseGesture()
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control
Dim OpenCmdMouseBinding As New MouseBinding()
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture
OpenCmdMouseBinding.Command = ApplicationCommands.Open
Me.InputBindings.Add(OpenCmdMouseBinding)
Hinweise
A MouseBinding associates a MouseGesture with an ICommand implementation. RoutedCommand ist die primäre Implementierung der ICommand Schnittstelle für das WPF-Befehlssystem. Im Allgemeinen MouseGesture wird der Befehl aufgerufen, obwohl das Befehlsverhalten weiter von befehlsspezifischen Faktoren wie dem CanExecute Wert beeinflusst wird. Weitere Informationen zum Befehlen finden Sie in der Befehlsübersicht.
Beim Definieren einer MouseBinding In extensible Application Markup Language (XAML) gibt es zwei Möglichkeiten zum Angeben der MouseGesture. Die erste Möglichkeit zum Einrichten eines MouseBinding XAML-Codes besteht darin, das Gesture Attribut des MouseBinding Elements zu definieren, mit dem eine Syntax Mausaktionen und Modifizierer als einzelne Zeichenfolge angeben kann, z. B. "STRG+LeftClick". Die zweite Möglichkeit besteht darin, das MouseAction Attribut des MouseBinding Elements zu definieren. Beide Methoden zum Festlegen MouseGesture der Einstellung sind gleichwertig und ändern dasselbe zugrunde liegende Objekt, es wird jedoch ein Konflikt auftreten, wenn beide verwendet werden. Wenn sowohl die Attribute als auch die MouseActionGesture Attribute festgelegt sind, ist die Geste ungültig. Im Allgemeinen wird empfohlen, nur das Gesture Attribut aus XAML zu verwenden, auch wenn Sie keine Modifizierer angeben. Dies vermeidet Mehrdeutigkeit, stellt die optimiertste Syntax bereit und stellt die einfachste Darstellung für die Serialisierung bereit.
A MouseBinding kann für ein bestimmtes Objekt oder auf Klassenebene definiert werden, indem eine RegisterClassInputBinding für die CommandManager Klasse registriert wird. Die am häufigsten zu definierende MouseBinding Methode befindet sich in der Steuerelementvorlage, indem Sie die InputBindings Eigenschaft in XAML festlegen, indem Sie mindestens ein Element MouseBindingKeyBinding deklarieren.
Konstruktoren
| Name | Beschreibung |
|---|---|
| MouseBinding() |
Initialisiert eine neue Instanz der MouseBinding-Klasse. |
| MouseBinding(ICommand, MouseGesture) |
Initialisiert eine neue Instanz der MouseBinding Klasse mithilfe der angegebenen Befehls- und Mausgeste. |
Felder
| Name | Beschreibung |
|---|---|
| MouseActionProperty |
Identifies the MouseAction dependency property. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanFreeze |
Ruft einen Wert ab, der angibt, ob das Objekt unveränderlich gemacht werden kann. (Geerbt von Freezable) |
| Command |
Dient zum Abrufen oder Festlegen der ICommand zugeordneten Eingabebindung. (Geerbt von InputBinding) |
| CommandParameter |
Dient zum Abrufen oder Festlegen der befehlsspezifischen Daten für einen bestimmten Befehl. (Geerbt von InputBinding) |
| CommandTarget |
Ruft das Zielelement des Befehls ab oder legt es fest. (Geerbt von InputBinding) |
| DependencyObjectType |
Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject) |
| Dispatcher |
Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject) |
| Gesture |
Ruft die dieser Geste zugeordnete MouseBindingGeste ab oder legt sie fest. |
| IsFrozen |
Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable) |
| IsSealed |
Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject) |
| MouseAction |
Dient zum Abrufen oder Festlegen des MouseAction zugeordneten Werts MouseBinding. |
Methoden
| Name | Beschreibung |
|---|---|
| CheckAccess() |
Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject) |
| Clone() |
Erstellt einen modifizierbaren Klon des FreezableObjekts, wobei tiefe Kopien der Werte des Objekts erstellt werden. 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. (Geerbt von Freezable) |
| CloneCore(Freezable) |
Kopiert die Basiswerte (nicht animiert) der Eigenschaften des angegebenen Objekts. |
| CloneCurrentValue() |
Erstellt einen modifizierbaren Klon (deep copy) der Freezable aktuellen Werte. (Geerbt von Freezable) |
| CloneCurrentValueCore(Freezable) |
Kopiert die aktuellen Werte der Eigenschaften des angegebenen Objekts. |
| CoerceValue(DependencyProperty) |
Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject) |
| CreateInstance() |
Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable) |
| CreateInstanceCore() |
Erstellt eine Instanz einer MouseBinding. |
| Equals(Object) |
Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject) |
| Freeze() |
Macht das aktuelle Objekt unveränderlich und legt seine IsFrozen Eigenschaft auf |
| FreezeCore(Boolean) |
Macht das Freezable Objekt unveränderlich oder prüft, ob es unveränderlich gemacht werden kann. (Geerbt von Freezable) |
| GetAsFrozen() |
Erstellt eine fixierte Kopie der Freezablebasisbasierten (nicht animierten) Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable) |
| GetAsFrozenCore(Freezable) |
Erstellt die Instanz mit einem fixierten Klon der angegebenen Freezable Basiseigenschaftswerte (nicht animiert). |
| GetCurrentValueAsFrozen() |
Erstellt eine fixierte Kopie der Freezable aktuellen Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Erstellt die aktuelle Instanz einen fixierten Klon des angegebenen Freezable. Wenn das Objekt animierte Abhängigkeitseigenschaften aufweist, werden die aktuellen animierten Werte kopiert. |
| GetHashCode() |
Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject) |
| GetLocalValueEnumerator() |
Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (Geerbt von DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnChanged() |
Wird aufgerufen, wenn das aktuelle Freezable Objekt geändert wird. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Dieses Mitglied unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Stellt sicher, dass geeignete Kontextzeiger für ein DependencyObjectType soeben festgelegtes Datenelement eingerichtet werden. (Geerbt von Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Setzt die DependencyObject Implementierung OnPropertyChanged(DependencyPropertyChangedEventArgs) außer Kraft, um auch alle Changed Handler als Reaktion auf eine sich ändernde Abhängigkeitseigenschaft vom Typ Freezableaufzurufen. (Geerbt von Freezable) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject) |
| ReadPreamble() |
Stellt sicher, dass der Freezable Zugriff über einen gültigen Thread erfolgt. Erber von Freezable müssen diese Methode am Anfang einer API aufrufen, die Datenmmber liest, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (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 wird. (Geerbt von DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| VerifyAccess() |
Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| WritePostscript() |
Löst das Changed Ereignis für die Freezable Methode aus und ruft es OnChanged() auf. Klassen, die von Freezable dieser Methode abgeleitet werden, sollten am Ende einer API aufgerufen werden, die Klassenmmber ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable) |
| WritePreamble() |
Überprüft, ob der Freezable Zugriff nicht fixiert ist und über einen gültigen Threadingkontext darauf zugegriffen wird. Freezable Vererbungen sollten diese Methode am Anfang einer API aufrufen, die in Datenmmber schreibt, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Changed |
Tritt auf, wenn das Freezable darin enthaltene Objekt geändert wird. (Geerbt von Freezable) |
