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
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.MouseGestureConverter))>]
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. キーが押されている間にマウスホイールをクリックすると ControlOpen が呼び出されます。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 MouseGestureUnlike 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 属性の使用では、通常、で設定されるプロパティ XAMLXAMLGesture 、ジェスチャがマウスアクションと1つ以上の修飾子キーの両方を表すことができる場合にはです。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.

MouseGestureXAMLXAMLオブジェクト要素の使用は可能ですが、通常は Gesture MouseBinding プロパティ要素の構文を使用せずにインラインのプロパティを設定できるため、一般的ではありません。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.

XAML 属性の使用方法XAML Attribute Usage

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

XAML 値XAML Values

mouseAction
MouseAction

1つのマウス操作。A single mouse action.

oneOrMoreModifierKeys
列挙体で定義される1つ以上の修飾子キー ModifierKeysOne 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)

指定した MouseGestureMouseAction を使用して、ModifierKeys クラスの新しいインスタンスを初期化します。Initializes a new instance of the MouseGesture class using the specified MouseAction and ModifierKeys.

プロパティ

Modifiers

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

適用対象

こちらもご覧ください