InputBinding::Command Property

 

Gets or sets the ICommand associated with this input binding.

Namespace:   System.Windows.Input
Assembly:  PresentationCore (in PresentationCore.dll)

public:
[LocalizabilityAttribute(LocalizationCategory::NeverLocalize)]
[TypeConverterAttribute("System.Windows.Input.CommandConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
property ICommand^ Command {
	virtual ICommand^ get() sealed;
	virtual void set(ICommand^ value) sealed;
}

Property Value

Type: System.Windows.Input::ICommand^

The associated command.

Exception Condition
ArgumentNullException

The Command value is null.

The InputBinding class does not support XAML usage because it does not expose a public default constructor (it has a default constructor, but it is protected). However, derived classes can expose a public constructor and therefore, can use properties that are inherited from InputBinding. Two existing InputBinding derived classes that can be instantiated in XAML and can set properties with XAML usages are KeyBinding and MouseBinding.

ICommand references a type converter that enables certain preexisting ICommand implementations to specify values in the form of a string. This type conversion behavior sets the attribute value form of this property. You can also bind the Command, CommandParameter, and CommandTarget properties to an ICommand that is defined on an object. This enables you to define a custom command and associate it with user input. For more information, see the second example in InputBinding.

<inputBindingDerivedClass Command="ICommand"/>

<inputBindingDerivedClass>
  <inputBindingDerivedClass.Command>
    <iCommandImplementation/>
  </inputBindingDerivedClass.Command>
</inputBindingDerivedClass>

inputBindingDerivedClass

A derived class of InputBinding that supports object element syntax, such as KeyBinding or MouseBinding. See Remarks.

iCommandImplementation

An object implementation of ICommand that supports object element syntax (has a public default constructor).

The following example shows how to use a KeyBinding to bind a KeyGesture to the ApplicationCommands::Open command. When the key gesture is performed, the Open command is invoked.

<Window.InputBindings>
  <KeyBinding Key="B"
              Modifiers="Control" 
              Command="ApplicationCommands.Open" />
</Window.InputBindings>
No code example is currently available or this language may not be supported.

.NET Framework
Available since 3.0
Return to top
Show: