次の方法で共有


KeyGesture クラス

定義

コマンドを呼び出すために使用できる、キーの組み合わせを定義します。

public ref class KeyGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))>]
type KeyGesture = class
    inherit InputGesture
Public Class KeyGesture
Inherits InputGesture
継承
KeyGesture
属性

次の例では、 を使用して コマンドを Close にバインドする KeyGesture 方法を KeyBinding示します。

KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

KeyBinding CloseKeyBinding = new KeyBinding(
    ApplicationCommands.Close, CloseCmdKeyGesture);

this.InputBindings.Add(CloseKeyBinding);
Dim CloseCmdKeyGesture As New KeyGesture(Key.L, ModifierKeys.Alt)

Dim CloseKeyBinding As New KeyBinding(ApplicationCommands.Close, CloseCmdKeyGesture)

Me.InputBindings.Add(CloseKeyBinding)

次の例は、XAML で を使用 KeyGesture する方法を示しています。 XAML の使用では、 要素が直接宣言されないことに <KeyGesture> 注意してください。 このオブジェクト要素は、パブリック パラメーターなしのコンストラクターを公開しないため KeyGesture 、使用できません。 代わりに、XAML の使用では typeconverter の動作を使用して、インライン全体 KeyGestureGesture 属性値として宣言します。

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>

注釈

ほとんどの場合、 は KeyGesture 1 つ以上 ModifierKeysに関連付けられている必要があります。 この規則の例外は、ファンクション キーとテンキー キーであり、それ自体で有効 KeyGesture にすることができます。 たとえば、F12 キーのみを使用して を KeyGesture 作成できますが、 で KeyGesture X キーを使用するには、修飾子キーとペアにする必要があります。

を使用KeyBindingして、 を にICommandバインドKeyGestureして、 が発生したときにKeyGestureコマンドが呼び出されるようにすることができます。

XAML を使用する場合 KeyGesture 、ジェスチャが標準キーと修飾子キーの両方を表す場合、XAML で一般的に設定される プロパティは Gestureです。 プロパティは Gesture 、単なる関数キーまたは修飾子キーの組み合わせに設定することもできます。 ただし、目的のコマンド バインドが修飾子のない関数キーである場合、またはModifiers目的のコマンド バインドが修飾子キー専用の場合は、 プロパティを設定Keyする方が一般的です。

XAML 属性の使用方法

<object property="oneOrMoreModifierKeys+key"/>  
- or -  
<object property="functionKey"/>  

XAML 値

functionKey
Key

1 つのキー値。ファンクション キー (F1 から 12) またはテンキーのいずれかである必要があります。

oneOrMoreModifierKeys
列挙体によって定義される 1 つ以上の ModifierKeys 修飾子キーは、"+" 文字で区切られます。

key
Key

1 つのキー値。

コンストラクター

KeyGesture(Key)

KeyGesture を指定して、Key クラスの新しいインスタンスを初期化します。

KeyGesture(Key, ModifierKeys)

指定された KeyGestureKey を使用して、ModifierKeys クラスの新しいインスタンスを初期化します。

KeyGesture(Key, ModifierKeys, String)

KeyGestureKey、および表示文字列を指定して、ModifierKeys クラスの新しいインスタンスを初期化します。

プロパティ

DisplayString

この KeyGesture の文字列表現を取得します。

Key

この KeyGesture に関連付けられているキーを取得します。

Modifiers

この KeyGesture に関連付けられている変換キーを取得します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetDisplayStringForCulture(CultureInfo)

KeyGesture の表示に使用できる文字列を返します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
Matches(Object, InputEventArgs)

指定した KeyGesture オブジェクトに関連付けられた入力に、この InputEventArgs が一致するかどうかを判断します。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象

こちらもご覧ください