KeyGesture KeyGesture KeyGesture KeyGesture Class

定義

コマンドを呼び出すために使用できる、キーの組み合わせを定義します。Defines a keyboard combination that can be used to invoke a command.

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

次の例は、をClose KeyGesture使用してKeyBindingコマンドをにバインドする方法を示しています。The following example shows how to bind the Close command to a KeyGesture using a 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)

次の例は、のKeyGesture XAMLXAMLを使用する方法を示しています。The following example shows how to use KeyGesture in XAMLXAML. 使用方法にXAMLXAMLよって要素が<KeyGesture>直接宣言されるわけではないことに注意してください。Note that the XAMLXAML usage does not directly declare a <KeyGesture> element. は、パラメーターなしのパブリックコンストラクターをKeyGesture公開しないため、このオブジェクト要素の使用はできません。That object element usage is not possible because KeyGesture does not expose a public parameterless constructor. 代わりに、typeconverter XAMLXAML動作を使用して、インライン全体KeyGestureGesture属性値として宣言します。Instead, the XAMLXAML usage uses the typeconverter behavior to declare an entire KeyGesture inline as the Gesture attribute value.

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

注釈

ほとんどの場合、 KeyGestureは1つModifierKeys以上のに関連付けられている必要があります。In most cases, a KeyGesture must be associated with one or more ModifierKeys. この規則の例外として、関数キーとテンキーのキーがあります。これはKeyGesture 、単独で有効にすることができます。The exceptions to this rule are the function keys and the numeric keypad keys, which can be a valid KeyGesture by themselves. たとえば、F12 キーのみを使用KeyGestureしてを作成できますが、 KeyGestureで X キーを使用するには、修飾子キーと対にする必要があります。For example, you can create a KeyGesture by using only the F12 key, but to use the X key in a KeyGesture it must be paired with a modifier key.

一般に、In general, you can

を使用KeyBindingすると、をKeyGestureICommandバインドして、がKeyGesture発生したときにコマンドが呼び出されるようにすることができます。You can use a KeyBinding to bind a KeyGesture to an ICommand, so that the command is invoked when the KeyGesture occurs.

使用KeyGestureするXAMLXAML場合、通常はでXAMLXAML設定されるプロパティGestureはです。これは、ジェスチャが標準キーと修飾子キーの両方を表している場合に使用されます。For KeyGesture XAMLXAML usages, the property that is generally set in XAMLXAML is Gesture, in cases where the gesture represents both a standard key and a modifier key. また、 Gestureプロパティを関数キーだけに設定することも、修飾子キーの組み合わせを使用することもできます。You can also set the Gesture property to be just a function key, or just a modifier key combination. ただし、意図したコマンドバインディングが修飾子Keyのない関数キーの場合、またはModifiers目的のコマンドバインドが修飾子キーの場合にのみ使用される場合は、プロパティを設定する方が一般的です。However, it is more common to set the Key property if the intended command binding is a function key with no modifiers, or Modifiers if the intended command binding is for modifier keys only.

XAML 属性の使用方法XAML Attribute Usage

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

XAML 値XAML Values

functionKey
Key

1つのキー値。関数キー (F1 + 12) またはテンキーのキーのいずれかである必要があります。A single key value, which must be one of the function keys (F1-12) or numeric keypad keys.

oneOrMoreModifierKeys
列挙体で定義されるModifierKeys 、"+" 文字で区切られた1つ以上の修飾キー。One or more modifier keys, defined by the ModifierKeys enumeration, delimited with a "+" character.

key
Key

1つのキー値。A single key value.

コンストラクター

KeyGesture(Key) KeyGesture(Key) KeyGesture(Key) KeyGesture(Key)

KeyGesture を指定して、Key クラスの新しいインスタンスを初期化します。Initializes a new instance of the KeyGesture class with the specified Key.

KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys) KeyGesture(Key, ModifierKeys)

指定された KeyGestureKey を使用して、ModifierKeys クラスの新しいインスタンスを初期化します。Initializes a new instance of the KeyGesture class with the specified Key and ModifierKeys.

KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String) KeyGesture(Key, ModifierKeys, String)

KeyGestureKey、および表示文字列を指定して、ModifierKeys クラスの新しいインスタンスを初期化します。Initializes a new instance of the KeyGesture class with the specified Key, ModifierKeys, and display string.

プロパティ

DisplayString DisplayString DisplayString DisplayString

この KeyGesture の文字列表現を取得します。Gets a string representation of this KeyGesture.

Key Key Key Key

この KeyGesture に関連付けられているキーを取得します。Gets the key associated with this KeyGesture.

Modifiers Modifiers Modifiers Modifiers

この KeyGesture に関連付けられている変換キーを取得します。Gets the modifier keys associated with this KeyGesture.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo) GetDisplayStringForCulture(CultureInfo)

KeyGesture の表示に使用できる文字列を返します。Returns a string that can be used to display the KeyGesture.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Matches(Object, InputEventArgs) Matches(Object, InputEventArgs) Matches(Object, InputEventArgs) Matches(Object, InputEventArgs)

指定した KeyGesture オブジェクトに関連付けられた入力に、この InputEventArgs が一致するかどうかを判断します。Determines whether this KeyGesture matches the input associated with the specified InputEventArgs object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください