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

例

次の例では、コマンドを using a にバインド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>

注釈

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

一般に、次のことができます。

a KeyBinding を使用して a KeyGesture に ICommandバインドし、発生したときに 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)

適用対象