KeyGesture クラス

リファレンス

定義

名前空間:: System.Windows.Input

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

継承: Object

InputGesture
KeyGesture

属性: TypeConverterAttribute

例

次の例では、を使用してコマンドを 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 の動作を使用して、インライン全体 KeyGesture を Gesture 属性値として宣言します。

<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)	指定された KeyGesture と Key を使用して、ModifierKeys クラスの新しいインスタンスを初期化します。
KeyGesture(Key, ModifierKeys, String)	KeyGesture、Key、および表示文字列を指定して、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)

適用対象