MouseGesture Classe

Definizione

Definisce un movimento di input del mouse che può essere utilizzato per richiamare un comando.Defines a mouse input gesture that can be used to invoke a command.

public ref class MouseGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.MouseGestureConverter))]
public class MouseGesture : System.Windows.Input.InputGesture
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.MouseGestureConverter))>]
type MouseGesture = class
    inherit InputGesture
Public Class MouseGesture
Inherits InputGesture
Ereditarietà
MouseGesture
Attributi

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto MouseGesture e associarlo a un oggetto RoutedCommand tramite un oggetto MouseBinding .The following example shows to create a MouseGesture and associate it with a RoutedCommand through a MouseBinding. Quando si fa clic sulla rotellina del mouse mentre Control viene premuto il tasto, Open viene richiamato.When the mouse wheel is clicked while the Control key is pressed, the Open is invoked.

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

Commenti

A differenza di KeyGesture , MouseAction non è necessario associare un oggetto a un oggetto ModifierKeys valido MouseGesture .Unlike a KeyGesture, a MouseAction does not have to be paired with ModifierKeys to be a valid MouseGesture.

Un oggetto MouseGesture può essere associato a un RoutedCommand (o ad altre ICommand implementazioni) tramite un oggetto in MouseBinding modo che il comando venga richiamato quando MouseGesture si verifica.A MouseGesture can be bound to a RoutedCommand (or other ICommand implementations) through a MouseBinding so that the command is invoked when the MouseGesture occurs.

Per MouseGesture gli utilizzi degli attributi XAML, la proprietà che viene in genere impostata in XAML è Gesture , nei casi in cui il movimento possa rappresentare sia un'azione del mouse che uno o più tasti di modifica.For MouseGesture XAML attribute usages, the property that is generally set in XAML is Gesture, in cases where the gesture can represent both a mouse action and one or more modifier key. È anche possibile impostare la Gesture Proprietà in modo che sia solo un'azione del mouse.You can also set the Gesture property to be just a mouse action. In generale, è consigliabile usare solo l' Gesture attributo da XAML, anziché l'impostazione MouseAction , anche se non si specificano i modificatori.In general, it is recommended that you use only the Gesture attribute from XAML, rather than setting MouseAction, even if you do not specify modifiers. Ciò consente di evitare ambiguità, fornisce la sintassi più semplificata e fornisce la rappresentazione più semplice per la serializzazione.This will avoid ambiguity, provides the most streamlined syntax, and provides the most straightforward representation for serialization.

MouseGesture Gli utilizzi degli elementi oggetto XAML sono possibili ma rari, perché in genere è possibile impostare la Gesture proprietà di MouseBinding inline senza utilizzare la sintassi dell'elemento Property.MouseGesture XAML object element usages are possible but uncommon, because you can ordinarily set the Gesture property of MouseBinding inline without the use of property element syntax.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object property="mouseAction"/>  
- or -  
<object property="oneOrMoreModifierKeys+mouseAction"/>  

Valori XAMLXAML Values

mouseAction
MouseAction

Singola azione del mouse.A single mouse action.

oneOrMoreModifierKeys
Uno o più tasti di modifica, definiti dall' ModifierKeys enumerazione.One or more modifier keys, defined by the ModifierKeys enumeration. Se viene specificato più di un tasto di modifica, ogni tasto di modifica è delimitato da un carattere "+".If more than one modifier key is provided, each modifier key is delimited with a "+" character.

Costruttori

MouseGesture()

Inizializza una nuova istanza della classe MouseGesture.Initializes a new instance of the MouseGesture class.

MouseGesture(MouseAction)

Inizializza una nuova istanza della classe MouseGesture usando il MouseAction specificato.Initializes a new instance of the MouseGesture class using the specified MouseAction.

MouseGesture(MouseAction, ModifierKeys)

Inizializza una nuova istanza della classe MouseGesture utilizzando gli oggetti MouseAction e ModifierKeys specificati.Initializes a new instance of the MouseGesture class using the specified MouseAction and ModifierKeys.

Proprietà

Modifiers

Ottiene o imposta i tasti di modifica associati con questo MouseGesture.Gets or sets the modifier keys associated with this MouseGesture.

MouseAction

Ottiene o imposta l'oggetto MouseAction associato a questo movimento.Gets or sets the MouseAction associated with this gesture.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
Matches(Object, InputEventArgs)

Determina se l'oggetto MouseGesture corrisponde all'input associato all'oggetto InputEventArgs specificato.Determines whether MouseGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche