KeyBinding KeyBinding KeyBinding KeyBinding Class

定義

KeyGestureRoutedCommand (または他の ICommand の実装) にバインドします。Binds a KeyGesture to a RoutedCommand (or another ICommand implementation).

public ref class KeyBinding : System::Windows::Input::InputBinding
public class KeyBinding : System.Windows.Input.InputBinding
type KeyBinding = class
    inherit InputBinding
Public Class KeyBinding
Inherits InputBinding
継承

次の例では、作成、KeyBindingにそれを追加し、InputBindingCollectionルート ウィンドウの。The following example creates a KeyBinding and adds it to the InputBindingCollection of the root window.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>
// Creating a KeyBinding between the Open command and Ctrl-R
KeyBinding OpenCmdKeyBinding = new KeyBinding(
    ApplicationCommands.Open, 
    Key.R, 
    ModifierKeys.Control);

this.InputBindings.Add(OpenCmdKeyBinding);
' Creating a KeyBinding between the Open command and Ctrl-R
Dim OpenCmdKeyBinding As New KeyBinding(ApplicationCommands.Open, Key.R, ModifierKeys.Control)

Me.InputBindings.Add(OpenCmdKeyBinding)

注釈

AKeyBinding関連付けます、KeyGestureで、ICommandなど、RoutedCommandします。A KeyBinding associates a KeyGesture with a ICommand, such as a RoutedCommand. RoutedCommand プライマリの実装、ICommandのためのインターフェイス、WPFWPFシステムのコマンドを実行します。RoutedCommand is the primary implementation of the ICommand interface for the WPFWPF commanding system . 通常、KeyGestureが実行されるコマンドが呼び出されたコマンドの動作はなどのコマンドに固有の要因によって左右さらには、CanExecute値。In general, when the KeyGesture is executed the command is invoked, although the command behavior is further influenced by command-specific factors such as the CanExecute value. コマンド実行の詳細については、次を参照してください。、コマンド実行の概要します。For more information on commanding, see the Commanding Overview.

ファンクション キーと有効なテンキー キーを除いてKeyGesture1 つだけ含める必要がありますKeyと 1 つ以上ModifierKeysします。With the exception of the function keys and the numeric keypad keys, a valid KeyGesture must contain exactly one Key and one or more ModifierKeys. ファンクション キーおよびテンキーのキーは必要ありません修飾子キーを有効にするにはKeyGestureします。Function keys and numeric keypad keys do not require a modifier key in order to be a valid KeyGesture. 無効なを指定することはKeyGestureKeyBindingに、無効ないずれかを使って、ジェスチャに関連付けXAMLXAMLまたはコード。It is possible to specify an invalid KeyGesture and a KeyBinding with an invalid associated gesture, either through XAMLXAML or code. たとえばを作成してバインドを妨げる検証はありません、KeyGesture修飾子がキーがない、またはのみ以外キーのみを格納しています。For instance, there is no validation that prevents creating and binding a KeyGesture that contains only a nonfunction key, or only modifiers but no key. このようなKeyBindingは決して呼び出そうとすると、関連付けられているコマンド。Such a KeyBinding will never attempt to invoke its associated command.

定義するときに、KeyBindingExtensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)を指定する 2 つの方法がある、KeyGestureします。When defining a KeyBinding in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) there are two ways to specify the KeyGesture. 最初の方法を確立するために、KeyBindingXAMLXAMLを定義する、Gestureの属性、KeyBindingにより、たとえば"CTRL + P"、1 つの文字列として、キーと修飾子を指定する構文の要素。The first way to establish a KeyBinding in XAMLXAML is to define the Gesture attribute of the KeyBinding element, which enables a syntax to specify keys and modifiers as a single string, for example "CTRL+P". 2 番目の方法が定義するには、Key属性とModifiersの属性、KeyBinding要素。The second way is to define the Key attribute and the Modifiers attributes of the KeyBinding element. 設定のどちらの方法、KeyGestureは同等と同一の基になるオブジェクトの変更がある場合は、両方の競合が使用されます。Both ways of setting the KeyGesture are equivalent and modify the same underlying object, but there will be a conflict if both are used. 場合と、 KeyModifiers、およびGesture属性は、すべての設定、定義されている属性は、最後に使用する、KeyGestureします。In the case when the Key, Modifiers, and the Gesture attributes are all set, the attribute which is defined last will be used for the KeyGesture. たとえば、状況を持つことがあります、Keyセット最後は上記のジェスチャのキー コンポーネントだけを上書きが、同じジェスチャの修飾子のままにします。You can potentially have situations where for example a Key set last will overwrite just the Key component of a preceding Gesture but leave the Gesture's modifiers the same. 一般に、お勧めのみに使用する、Gesture属性からXAMLXAML; このあいまいさを避ける、最も簡潔な構文について説明し、シリアル化のための最も簡単な表現を提供します。In general, it is recommended that you use only the Gesture attribute from XAMLXAML; this will avoid ambiguity, provides the most streamlined syntax, and provides the most straightforward representation for serialization.

AKeyBinding登録することによって特定のオブジェクトまたはクラス レベルで定義できますをRegisterClassInputBinding上、CommandManagerクラス。A KeyBinding can be defined on a specific object or at the class level by registering a RegisterClassInputBinding on the CommandManager class. 定義する最も一般的な方法をKeyBinding設定、コントロール テンプレート内では、InputBindingsプロパティXAMLXAML1 つまたは複数を宣言することでMouseBindingまたはKeyBinding要素。The most typical way to define a KeyBinding is within the control template, setting the InputBindings property in XAMLXAML by declaring one or more MouseBinding or KeyBinding elements.

コンストラクター

KeyBinding() KeyBinding() KeyBinding() KeyBinding()

KeyBinding クラスの新しいインスタンスを初期化します。Initializes a new instance of the KeyBinding class.

KeyBinding(ICommand, Key, ModifierKeys) KeyBinding(ICommand, Key, ModifierKeys) KeyBinding(ICommand, Key, ModifierKeys) KeyBinding(ICommand, Key, ModifierKeys)

指定した KeyBinding と指定した ICommand および Key に変換される ModifierKeys を使用して、KeyGesture クラスの新しいインスタンスを初期化します。Initializes a new instance of the KeyBinding class using the specified ICommand and the specified Key and ModifierKeys which will be converted into a KeyGesture.

KeyBinding(ICommand, KeyGesture) KeyBinding(ICommand, KeyGesture) KeyBinding(ICommand, KeyGesture) KeyBinding(ICommand, KeyGesture)

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

フィールド

KeyProperty KeyProperty KeyProperty KeyProperty

Key 依存関係プロパティを識別します。Identifies the Key dependency property.

ModifiersProperty ModifiersProperty ModifiersProperty ModifiersProperty

Modifiers 依存関係プロパティを識別します。Identifies the Modifiers dependency property.

プロパティ

Command Command Command Command

この入力バインドに関連付けられる ICommand を取得または設定します。Gets or sets the ICommand associated with this input binding.

(Inherited from InputBinding)
CommandParameter CommandParameter CommandParameter CommandParameter

取得または特定のコマンドのコマンドに固有のデータを設定します。Gets or sets the command-specific data for a particular command.

(Inherited from InputBinding)
CommandTarget CommandTarget CommandTarget CommandTarget

取得またはコマンドのターゲット要素を設定します。Gets or sets the target element of the command.

(Inherited from InputBinding)
DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

このインスタンスの CLRCLR 型をラップする DependencyObjectType を取得します。Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

取得、DispatcherこのDispatcherObjectに関連付けられています。Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Gesture Gesture Gesture Gesture

この KeyBinding に関連付けられているジェスチャを取得または設定します。Gets or sets the gesture associated with this KeyBinding.

IsSealed IsSealed IsSealed IsSealed

このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Key Key Key Key

この Key に関連付けられている KeyGestureKeyBinding を取得または設定します。Gets or sets the Key of the KeyGesture associated with this KeyBinding.

Modifiers Modifiers Modifiers Modifiers

この ModifierKeys に関連付けられている KeyGestureKeyBinding を取得または設定します。Gets or sets the ModifierKeys of the KeyGesture associated with this KeyBinding.

メソッド

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

呼び出し元のスレッドが、これに対するアクセス権を持つかどうかを判断しますDispatcherObjectします。Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

プロパティのローカル値をクリアします。Clears the local value of a property. クリアするプロパティは DependencyProperty 識別子で指定されます。The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

読み取り専用プロパティのローカル値を消去します。Clears the local value of a read-only property. 消去するプロパティは、DependencyPropertyKey で指定します。The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable)

指定したオブジェクトのプロパティの基本 (アニメーション化されていない) 値をコピーします。Copies the base (non-animated) values of the properties of the specified object.

(Inherited from InputBinding)
CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable)

指定したオブジェクトのプロパティの現在の値をコピーします。Copies the current values of the properties of the specified object.

(Inherited from InputBinding)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

指定した依存関係プロパティの値を強制します。Coerces the value of the specified dependency property. これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CreateInstanceCore() CreateInstanceCore() CreateInstanceCore() CreateInstanceCore()

KeyBinding のインスタンスを作成します。Creates an instance of a KeyBinding.

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

指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable)

インスタンスの指定した固定された複製は、Freezable基本 (アニメーション化されていない) のプロパティの値を使用しています。Makes the instance a frozen clone of the specified Freezable by using base (non-animated) property values.

(Inherited from InputBinding)
GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable)

現在のインスタンスを、指定した Freezable の固定された複製にします。Makes the current instance a frozen clone of the specified Freezable. オブジェクトに、アニメーション化された依存関係プロパティが存在する場合、現在アニメーション化されている値がコピーされます。If the object has animated dependency properties, their current animated values are copied.

(Inherited from InputBinding)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

この DependencyObject のハッシュ コードを取得します。Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

指定した依存関係プロパティの有効値を再評価します。Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

この DependencyObject の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 変更が発生した特定の依存関係プロパティがイベント データで報告されます。The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

ローカルの依存関係プロパティの値を返します (存在する場合)。Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

依存関係プロパティ値のソースを変更せずにその値を設定します。Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

呼び出し元のスレッドがこのへのアクセスを強制DispatcherObjectします。Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

適用対象

こちらもご覧ください