MouseGesture Класс

Определение

Определяет жест ввода мыши, который может использоваться для вызова команды.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
type MouseGesture = class
    inherit InputGesture
Public Class MouseGesture
Inherits InputGesture
Наследование
MouseGesture
Атрибуты

Примеры

В следующем примере показано, как создать MouseGesture и связать его с RoutedCommand с помощью MouseBinding.The following example shows to create a MouseGesture and associate it with a RoutedCommand through a MouseBinding. При нажатии колесика мыши, когда нажимается клавиша Control, вызывается Open.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)

Комментарии

В отличие от KeyGesture, MouseAction не обязательно должны быть парными с ModifierKeys, чтобы быть допустимым MouseGesture.Unlike a KeyGesture, a MouseAction does not have to be paired with ModifierKeys to be a valid MouseGesture.

MouseGesture можно привязать к RoutedCommand (или другим реализациям ICommand) через MouseBinding, чтобы команда вызывалась при возникновении MouseGesture.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.

Для MouseGesture XAMLXAML использования атрибутов свойство, обычно заданное в XAMLXAML, имеет Gesture, в случаях, когда жест может представлять как действие мыши, так и один или несколько клавиш-модификаторов.For MouseGesture XAMLXAML attribute usages, the property that is generally set in XAMLXAML is Gesture, in cases where the gesture can represent both a mouse action and one or more modifier key. Можно также задать свойство Gesture как просто действие мыши.You can also set the Gesture property to be just a mouse action. Как правило, рекомендуется использовать только Gesture атрибут из XAMLXAML, а не устанавливать MouseAction, даже если не заданы модификаторы.In general, it is recommended that you use only the Gesture attribute from XAMLXAML, rather than setting MouseAction, even if you do not specify modifiers. Это позволит избежать неоднозначности, предоставляет самый упрощенный синтаксис и предоставляет наиболее простое представление для сериализации.This will avoid ambiguity, provides the most streamlined syntax, and provides the most straightforward representation for serialization.

MouseGesture XAMLXAML использования объектных элементов являются возможными, но редкими, так как обычно можно задать свойство Gesture MouseBinding Inline без использования синтаксиса элемента свойства.MouseGesture XAMLXAML 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.

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

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

Значения XAMLXAML Values

mouseAction
MouseAction

Одно действие мыши.A single mouse action.

oneOrMoreModifierKeys
Один или несколько клавиш модификатора, определяемых перечислением ModifierKeys.One or more modifier keys, defined by the ModifierKeys enumeration. Если предоставлено более одной клавиши-модификатора, каждая клавиша-модификатора отделяется символом "+".If more than one modifier key is provided, each modifier key is delimited with a "+" character.

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

MouseGesture()

Инициализирует новый экземпляр класса MouseGesture.Initializes a new instance of the MouseGesture class.

MouseGesture(MouseAction)

Инициализирует новый экземпляр класса MouseGesture с помощью указанного объекта MouseAction.Initializes a new instance of the MouseGesture class using the specified MouseAction.

MouseGesture(MouseAction, ModifierKeys)

Инициализирует новый экземпляр класса MouseGesture с использованием указанных объектов MouseAction и ModifierKeys.Initializes a new instance of the MouseGesture class using the specified MouseAction and ModifierKeys.

Свойства

Modifiers

Получает или задает клавиши CTRL, SHIFT или ALT, связанные с MouseGesture.Gets or sets the modifier keys associated with this MouseGesture.

MouseAction

Получает или задает MouseAction, связанный с данным жестом.Gets or sets the MouseAction associated with this gesture.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
Matches(Object, InputEventArgs)

Определяет, соответствует ли MouseGesture вводу, связанному с заданным объектом InputEventArgs.Determines whether MouseGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно