MouseGesture Класс

Определение

Пространство имен:

System.Windows.Input

Сборка:

PresentationCore.dll

Определяет жест ввода мыши, который можно использовать для вызова команды.

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

Наследование

Object

InputGesture

MouseGesture

Атрибуты

TypeConverterAttribute

Примеры

В следующем примере показано, как создать MouseGesture и связать его с RoutedCommand помощью .MouseBinding Когда колесико мыши щелкается при Control нажатии клавиши, Open вызывается.

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

Комментарии

В отличие от a KeyGesture, MouseAction не обязательно быть сопряженным с ModifierKeys допустимым MouseGesture.

Можно MouseGesture привязать к RoutedCommand (или другим ICommand реализациям) с помощью MouseBinding команды, которая вызывается при возникновении MouseGesture этой команды.

Для MouseGesture использования атрибутов XAML свойство, которое обычно задано в XAML, в Gestureслучаях, когда жест может представлять как действие мыши, так и один или несколько клавиш модификатора. Вы также можете задать Gesture свойство как действие мыши. Как правило, рекомендуется использовать только Gesture атрибут из XAML, а не задать MouseAction, даже если не указывать модификаторы. Это позволит избежать неоднозначности, предоставляет наиболее упрощенный синтаксис и предоставляет наиболее простое представление для сериализации.

MouseGesture Использование элементов объекта XAML возможно, но редко, так как обычно можно задать Gesture свойство встроенного MouseBinding без использования синтаксиса элемента свойства.

Использование атрибута XAML

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

Значения XAML

mouseAction MouseAction

Одно действие мыши.

oneOrMoreModifierKeys Один или несколько ключей модификатора, определенных ModifierKeys перечислением. Если указано несколько клавиш модификатора, каждый ключ модификатора разделен символом "+".

Конструкторы

Имя	Описание
MouseGesture()	Инициализирует новый экземпляр класса MouseGesture.
MouseGesture(MouseAction, ModifierKeys)	Инициализирует новый экземпляр класса с помощью указанного MouseGestureMouseAction и ModifierKeys.
MouseGesture(MouseAction)	Инициализирует новый экземпляр класса с помощью указанного MouseGestureMouseAction.

Свойства

Имя	Описание
Modifiers	Возвращает или задает ключи модификатора, связанные с этим MouseGesture.
MouseAction	Возвращает или задает связанный с этим жестом MouseAction .

Методы

Имя	Описание
Matches(Object, InputEventArgs)	Определяет, совпадают ли MouseGesture входные данные, связанные с указанным InputEventArgs объектом.

См. также раздел

• MouseBinding
• KeyGesture
• KeyBinding
• RoutedCommand
• CommandBinding