InputBinding InputBinding InputBinding InputBinding Class


InputGesture とコマンドの間のバインディングを表します。Represents a binding between an InputGesture and a command. コマンドは、RoutedCommand の可能性があります。The command is potentially a RoutedCommand.

public ref class InputBinding : System::Windows::Freezable, System::Windows::Input::ICommandSource
public class InputBinding : System.Windows.Freezable, System.Windows.Input.ICommandSource
type InputBinding = class
    inherit Freezable
    interface ICommandSource
Public Class InputBinding
Inherits Freezable
Implements ICommandSource

次の例は、使用する方法を示します、KeyBindingにバインドする、KeyGestureOpenコマンド。The following example shows how to use a KeyBinding to bind a KeyGesture to the Open command. キーのジェスチャを実行すると、時に、開いているコマンドが呼び出されます。When the key gesture is performed, the Open command is invoked.

  <KeyBinding Key="B"
              Command="ApplicationCommands.Open" />

次の例にカスタム コマンドをバインドする方法を示してInputBindingオブジェクト。The following examples show how to bind a custom command to InputBinding objects. これらの例では、ユーザーが、次の操作のいずれかの操作を実行することによって、背景色を変更できるようにするアプリケーションを作成します。These examples create an application that enables the user to change the background color by performing one of the following actions:

  • ボタンをクリックします。Clicking a button.

  • Ctrl キーを押しながら C キーを押します。Pressing CTRL+C.

  • 右クリックし、 StackPanel (外部、 ListBox)。Right-clicking a StackPanel (outside the ListBox).

最初の例では、という名前のクラスを作成するSimpleDelegateCommandします。The first example creates a class named SimpleDelegateCommand. このクラスは、コマンドを作成するオブジェクトは、コマンドが実行されるときに発生するアクションを定義できるように、デリゲートを受け取ります。This class accepts a delegate so that the object creating the command can define the action that occurs when the command executes. SimpleDelegateCommand キーし、マウスの内容を指定するプロパティにも定義入力は、コマンドを呼び出します。SimpleDelegateCommand also defines properties that specify what key and mouse input invokes the command. GestureKey GestureModifierキーボード入力の指定MouseGestureマウス入力を指定します。GestureKey and GestureModifier specify the keyboard input; MouseGesture specifies the mouse input.

 // Create a class that implements ICommand and accepts a delegate.
public class SimpleDelegateCommand : ICommand
    // Specify the keys and mouse actions that invoke the command. 
    public Key GestureKey { get; set; }
    public ModifierKeys GestureModifier { get; set; }
    public MouseAction MouseGesture { get; set; }

    Action<object> _executeDelegate;

    public SimpleDelegateCommand(Action<object> executeDelegate)
        _executeDelegate = executeDelegate;

    public void Execute(object parameter)

    public bool CanExecute(object parameter) { return true; }
    public event EventHandler CanExecuteChanged;
' Create a class that implements ICommand and accepts a delegate. 
Public Class SimpleDelegateCommand
    Implements ICommand

    ' Specify the keys and mouse actions that invoke the command. 
    Private _GestureKey As Key
    Private _GestureModifier As ModifierKeys
    Private _MouseGesture As MouseAction

    Public Property GestureKey() As Key
            Return _GestureKey
        End Get
        Set(ByVal value As Key)
            _GestureKey = value
        End Set
    End Property

    Public Property GestureModifier() As ModifierKeys
            Return _GestureModifier
        End Get
        Set(ByVal value As ModifierKeys)
            _GestureModifier = value
        End Set
    End Property

    Public Property MouseGesture() As MouseAction
            Return _MouseGesture
        End Get
        Set(ByVal value As MouseAction)
            _MouseGesture = value
        End Set
    End Property

    Private _executeDelegate As Action(Of Object)

    Public Sub New(ByVal executeDelegate As Action(Of Object))
        _executeDelegate = executeDelegate
    End Sub

    Public Sub Execute(ByVal parameter As Object) _
        Implements ICommand.Execute

    End Sub

    Public Function CanExecute(ByVal parameter As Object) As Boolean _
        Implements ICommand.CanExecute

        Return True
    End Function

    Public Event CanExecuteChanged As EventHandler _
        Implements ICommand.CanExecuteChanged
End Class

次の例では、作成し、初期化、 ColorChangeCommand、これは、SimpleDelegateCommandします。The following example creates and initializes the ColorChangeCommand, which is a SimpleDelegateCommand. コマンドが呼び出され、設定時に実行されるメソッドも定義、 GestureKeyGestureModifier、およびMouseGestureプロパティ。The example also defines the method that executes when the command is invoked and sets the GestureKey, GestureModifier, and MouseGesture properties. アプリケーションを呼び出すと、InitializeCommandメソッド、プログラムの開始時に、コンス トラクターのように、Windowします。An application would call the InitializeCommand method when the program begins, such as in the constructor of a Window.

public SimpleDelegateCommand ChangeColorCommand
    get { return changeColorCommand; }

private SimpleDelegateCommand changeColorCommand;

private void InitializeCommand()
    originalColor = this.Background;

    changeColorCommand = new SimpleDelegateCommand(x => this.ChangeColor(x));

    DataContext = this;
    changeColorCommand.GestureKey = Key.C;
    changeColorCommand.GestureModifier = ModifierKeys.Control;
    ChangeColorCommand.MouseGesture = MouseAction.RightClick;

private Brush originalColor, alternateColor;

// Switch the Background color between
// the original and selected color.
private void ChangeColor(object colorString)
    if (colorString == null)

    Color newColor = 
    alternateColor = new SolidColorBrush(newColor);

    if (this.Background == originalColor)
        this.Background = alternateColor;
        this.Background = originalColor;
Public ReadOnly Property ChangeColorCommand() As SimpleDelegateCommand
        Return _changeColorCommand
    End Get
End Property

Private _changeColorCommand As SimpleDelegateCommand
Private originalColor As Brush, alternateColor As Brush

Private Sub InitializeCommand()
    originalColor = Me.Background

    _changeColorCommand = New SimpleDelegateCommand(Function(x) Me.ChangeColor(x))

    DataContext = Me
    _changeColorCommand.GestureKey = Key.C
    _changeColorCommand.GestureModifier = ModifierKeys.Control
    _changeColorCommand.MouseGesture = MouseAction.RightClick
End Sub

' Switch the Background color between 
' the original and selected color. 
Private Function ChangeColor(ByVal colorString As Object) As Integer

    If colorString Is Nothing Then
        Return 0
    End If

    Dim newColor As Color = DirectCast(ColorConverter.ConvertFromString(DirectCast(colorString, [String])), Color)

    alternateColor = New SolidColorBrush(newColor)

    If Brush.Equals(Me.Background, originalColor) Then
        Me.Background = alternateColor
        Me.Background = originalColor
    End If

    Return 0
End Function

最後に、次の例は、ユーザー インターフェイスを作成します。Finally, the following example creates the user interface. 例では、追加、KeyBindingMouseBindingStackPanelを格納している、ButtonListBoxします。The example adds a KeyBinding and a MouseBinding to a StackPanel that contains a Button and a ListBox. ユーザーが内の項目を選択すると、 ListBox、選択した色を背景の色を変更できますか。When the user selects an item in the ListBox, he or she can change the color of the background to the selected color. 各ケースで、CommandParameterプロパティで選択された項目にバインドする、 ListBox、およびCommandプロパティにバインドする、ColorChangeCommandします。In each case, the CommandParameter property is bound to the selected item in the ListBox, and the Command property is bound to the ColorChangeCommand. KeyBinding.KeyKeyBinding.Modifiers、およびMouseBinding.MouseActionプロパティ対応するプロパティにバインドされている、SimpleDelegateCommandクラス。The KeyBinding.Key, KeyBinding.Modifiers, and MouseBinding.MouseAction properties are bound to the corresponding properties on the SimpleDelegateCommand class.

<StackPanel Background="Transparent">
    <KeyBinding Command="{Binding ChangeColorCommand}"
                CommandParameter="{Binding ElementName=colorPicker, Path=SelectedItem}"
                Key="{Binding ChangeColorCommand.GestureKey}"
                Modifiers="{Binding ChangeColorCommand.GestureModifier}"/>

    <MouseBinding Command="{Binding ChangeColorCommand}"
                  CommandParameter="{Binding ElementName=colorPicker, Path=SelectedItem}"
                  MouseAction="{Binding ChangeColorCommand.MouseGesture}"/>
  <Button Content="Change Color" 
          Command="{Binding ChangeColorCommand}" 
          CommandParameter="{Binding ElementName=colorPicker, Path=SelectedItem}">

  <ListBox Name="colorPicker"


ユーザー入力が作成してコマンドを呼び出すことを指定することができます、InputBindingします。You can specify that user input invokes a command by creating a InputBinding. ユーザーが指定された入力を実行するときに、ICommandに設定されている、Commandプロパティを実行します。When the user performs the specified input, the ICommand that is set to the Command property is executed.

指定することができます、InputBindingでバインディングを作成するオブジェクトで定義されているコマンドを呼び出す、 CommandCommandParameter、およびCommandTargetプロパティ。You can specify that the InputBinding invokes a command that is defined on an object by creating a binding on the Command, CommandParameter, and CommandTarget properties. これにより、カスタム コマンドを定義し、ユーザー入力に関連付けることができます。This enables you to define a custom command and associate it with user input. 詳細については、「例」の 2 番目の例を参照してください。For more information, see the second example in the Examples section.

InputBinding登録することによって特定のオブジェクトまたはクラス レベルで定義できますをRegisterClassInputBindingで、CommandManagerします。An InputBinding can be defined on a specific object or at the class level by registering a RegisterClassInputBinding with the CommandManager.

InputBindingクラス自体が XAML の使用をサポートしていない既定のパブリック コンス トラクターが公開しないため (既定のコンス トラクターがあるが、保護されている)。The InputBinding class itself does not support XAML usage because it does not expose a public default constructor (there is a default constructor, but it is protected). ただし、派生クラスのパブリック コンス トラクターを公開することができ、派生クラスから継承されたプロパティを設定できますのでInputBindingXAML の使用状況とします。However, derived classes can expose a public constructor and therefore can set properties on the derived class that are inherited from InputBinding with a XAML usage. 既存の 2 つInputBinding-を XAML でインスタンス化して、XAML でプロパティを設定する派生クラスはKeyBindingMouseBindingします。Two existing InputBinding-derived classes that can be instantiated in XAML and can set properties in XAML are KeyBinding and MouseBinding. 一般的なプロパティWPFWPF1 つまたは複数と XAML で設定されているプログラミングInputBindingオブジェクトを値としては、UIElement.InputBindingsプロパティ。The typical property in WPFWPF programming that is set in XAML and takes one or more InputBinding objects as values is the UIElement.InputBindings property.

XAML オブジェクト要素の使用方法XAML Object Element Usage



派生クラスのInputBindingなどオブジェクト要素構文をサポートするKeyBindingまたはMouseBindingします。A derived class of InputBinding that supports object element syntax, such as KeyBinding or MouseBinding. 「解説」を参照してください。See Remarks.


InputBinding() InputBinding() InputBinding() InputBinding()

InputBinding から派生したクラスの基本の初期化を行います。Provides base initialization for classes derived from InputBinding.

InputBinding(ICommand, InputGesture) InputBinding(ICommand, InputGesture) InputBinding(ICommand, InputGesture) InputBinding(ICommand, InputGesture)

コマンドおよび入力ジェスチャを指定して、InputBinding クラスの新しいインスタンスを初期化します。Initializes a new instance of the InputBinding class with the specified command and input gesture.


CommandParameterProperty CommandParameterProperty CommandParameterProperty CommandParameterProperty

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

CommandProperty CommandProperty CommandProperty CommandProperty

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

CommandTargetProperty CommandTargetProperty CommandTargetProperty CommandTargetProperty

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


Command Command Command Command

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

CommandParameter CommandParameter CommandParameter CommandParameter

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

CommandTarget CommandTarget CommandTarget CommandTarget

コマンドの対象要素を取得または設定します。Gets or sets the target element of the command.

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

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

IsSealed IsSealed IsSealed IsSealed

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

(Inherited from DependencyObject)


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.

CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable)

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

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()

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

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.

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.

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)