MouseBinding Classe

Définition

Lie un MouseGesture à un RoutedCommand (ou une autre implémentation d'ICommand).Binds a MouseGesture to a RoutedCommand (or another ICommand implementation).

public ref class MouseBinding : System::Windows::Input::InputBinding
public class MouseBinding : System.Windows.Input.InputBinding
type MouseBinding = class
    inherit InputBinding
Public Class MouseBinding
Inherits InputBinding
Héritage
Héritage

Exemples

L’exemple suivant montre comment utiliser un MouseBinding pour lier un MouseGesture à un RoutedCommand.The following example shows how to use a MouseBinding to bind a MouseGesture to a 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)

Remarques

Un MouseBinding associe un MouseGesture à une implémentation de ICommand.A MouseBinding associates a MouseGesture with an ICommand implementation. RoutedCommand est l’implémentation principale de l’interface ICommand pour le système de commande WPFWPF.RoutedCommand is the primary implementation of the ICommand interface for the WPFWPF commanding system. En général, lorsque le MouseGesture est exécuté, la commande est appelée, bien que le comportement de la commande soit encore influencé par des facteurs spécifiques à la commande, tels que la valeur CanExecute.In general, when the MouseGesture is executed, the command is invoked, although the command behavior is further influenced by command-specific factors such as the CanExecute value. Pour plus d’informations sur les commandes, consultez vue d’ensemble des commandes.For more information on commanding, see the Commanding Overview.

Lors de la définition d’un MouseBinding dans langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML), il existe deux façons de spécifier le MouseGesture.When defining a MouseBinding in langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML), there are two ways to specify the MouseGesture. La première façon d’établir un MouseBinding dans XAMLXAML consiste à définir l’attribut Gesture de l’élément MouseBinding, ce qui permet à une syntaxe de spécifier des actions et des modificateurs de souris sous la forme d’une chaîne unique. par exemple, « CTRL + LeftClick ».The first way to establish a MouseBinding in XAMLXAML is to define the Gesture attribute of the MouseBinding element, which enables a syntax to specify mouse actions and modifiers as a single string; for example, "CTRL+LeftClick". La seconde consiste à définir l’attribut MouseAction de l’élément MouseBinding.The second way is to define the MouseAction attribute of the MouseBinding element. Les deux méthodes de définition des MouseGesture sont équivalentes et modifient le même objet sous-jacent, mais il y aura un conflit si les deux sont utilisés.Both ways of setting the MouseGesture are equivalent and modify the same underlying object, but there will be a conflict if both are used. Dans le cas où les MouseAction et les attributs Gesture sont définis, le mouvement n’est pas valide.In the case when the MouseAction and the Gesture attributes are both set, the gesture is invalid. En général, il est recommandé d’utiliser uniquement l’attribut Gesture de XAMLXAML, même si vous ne spécifiez pas de modificateurs ; Cela évite toute ambiguïté, fournit la syntaxe la plus rationalisée et fournit la représentation la plus simple pour la sérialisation.In general, it is recommended that you use only the Gesture attribute from XAMLXAML, even if you do not specify modifiers; this avoids ambiguity, provides the most streamlined syntax, and provides the most straightforward representation for serialization.

Un MouseBinding peut être défini sur un objet spécifique ou au niveau de la classe en inscrivant un RegisterClassInputBinding sur la classe CommandManager.A MouseBinding can be defined on a specific object or at the class level by registering a RegisterClassInputBinding on the CommandManager class. La méthode la plus courante pour définir un MouseBinding se trouve dans le modèle de contrôle, la définition de la propriété InputBindings dans XAMLXAML en déclarant un ou plusieurs éléments MouseBinding ou KeyBinding.The most typical way to define a MouseBinding is within the control template, setting the InputBindings property in XAMLXAML by declaring one or more MouseBinding or KeyBinding elements.

Constructeurs

MouseBinding()

Initialise une nouvelle instance de la classe MouseBinding.Initializes a new instance of the MouseBinding class.

MouseBinding(ICommand, MouseGesture)

Initialise une nouvelle instance de la classe MouseBinding en utilisant la commande et le mouvement de souris spécifiés.Initializes a new instance of the MouseBinding class, using the specified command and mouse gesture.

Champs

MouseActionProperty

Identifie la propriété de dépendance MouseAction.Identifies the MouseAction dependency property.

Propriétés

CanFreeze

Obtient une valeur qui indique si l’objet peut être rendu non modifiable.Gets a value that indicates whether the object can be made unmodifiable.

(Hérité de Freezable)
Command

Obtient ou définit le ICommand associé à cette liaison d’entrée.Gets or sets the ICommand associated with this input binding.

(Hérité de InputBinding)
CommandParameter

Obtient ou définit les données spécifiques à la commande pour une commande particulière.Gets or sets the command-specific data for a particular command.

(Hérité de InputBinding)
CommandTarget

Obtient ou définit l'élément cible de la commande.Gets or sets the target element of the command.

(Hérité de InputBinding)
DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Hérité de DispatcherObject)
Gesture

Obtient ou définit le mouvement associé à ce MouseBinding.Gets or sets the gesture associated with this MouseBinding.

IsFrozen

Obtient une valeur qui indique si l’objet est actuellement modifiable.Gets a value that indicates whether the object is currently modifiable.

(Hérité de Freezable)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Hérité de DependencyObject)
MouseAction

Obtient ou définit l'objet MouseAction associé à MouseBinding.Gets or sets the MouseAction associated with this MouseBinding.

Méthodes

CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Hérité de DependencyObject)
Clone()

Crée un clone modifiable de Freezable, en créant des copies complètes des valeurs de l’objet.Creates a modifiable clone of the Freezable, making deep copies of the object's values. Lors de la copie des propriétés de dépendance de l’objet, cette méthode copie les expressions (qui peuvent ne plus se résoudre), mais pas les animations ni leurs valeurs actuelles.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Hérité de Freezable)
CloneCore(Freezable)

Copie les valeurs de base (non animées) des propriétés de l'objet spécifié.Copies the base (non-animated) values of the properties of the specified object.

CloneCurrentValue()

Crée un clone modifiable (copie complète) de Freezable en utilisant ses valeurs actuelles.Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Hérité de Freezable)
CloneCurrentValueCore(Freezable)

Copie les valeurs actuelles des propriétés de l'objet spécifié.Copies the current values of the properties of the specified object.

CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Hérité de DependencyObject)
CreateInstance()

Initialise une nouvelle instance de la classe Freezable.Initializes a new instance of the Freezable class.

(Hérité de Freezable)
CreateInstanceCore()

Crée une instance de MouseBinding.Creates an instance of an MouseBinding.

Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Hérité de DependencyObject)
Freeze()

Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Hérité de Freezable)
FreezeCore(Boolean)

Rend l'objet Freezable non modifiable ou vérifie si celui-ci peut être rendu non modifiable ou pas.Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Hérité de Freezable)
GetAsFrozen()

Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base.Creates a frozen copy of the Freezable, using base (non-animated) property values. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Hérité de Freezable)
GetAsFrozenCore(Freezable)

Crée l’instance en clone figé du Freezable spécifié utilisant des valeurs de propriété (non animée) de base.Creates the instance a frozen clone of the specified Freezable by using base (non-animated) property values.

GetCurrentValueAsFrozen()

Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles.Creates a frozen copy of the Freezable using current property values. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Crée l'instance actuelle en un clone figé du Freezable spécifié.Creates the current instance a frozen clone of the specified Freezable. Si l’objet a des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées.If the object has animated dependency properties, their current animated values are copied.

GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this DependencyObject.

(Hérité de DependencyObject)
GetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.Re-evaluates the effective value for the specified dependency property.

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnChanged()

Appelé lorsque l’objet Freezable actuel est modifié.Called when the current Freezable object is modified.

(Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) et n’est pas destiné à être directement utilisé à partir de votre code.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.The specific dependency property that changed is reported in the event data.

(Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

(Hérité de DependencyObject)
ReadPreamble()

Garantit que Freezable est accessible à partir d'un thread valide.Ensures that the Freezable is being accessed from a valid thread. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Hérité de Freezable)
SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.Sets the value of a dependency property without changing its value source.

(Hérité de DependencyObject)
SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.Sets the local value of a dependency property, specified by its dependency property identifier.

(Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Hérité de DependencyObject)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)
WritePostscript()

Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance.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.

(Hérité de Freezable)
WritePreamble()

Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant dans les membres de données qui ne sont pas des propriétés de dépendance.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Hérité de Freezable)

Événements

Changed

Se produit lorsque Freezable ou un objet qu'il contient est modifié.Occurs when the Freezable or an object it contains is modified.

(Hérité de Freezable)

S’applique à

Voir aussi