InputBinding.Command Propriedade

Referência

Definição

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o ICommand associado a essa associação de entrada.

public:
 property System::Windows::Input::ICommand ^ Command { System::Windows::Input::ICommand ^ get(); void set(System::Windows::Input::ICommand ^ value); };

[System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public System.Windows.Input.ICommand Command { get; [System.Security.SecurityCritical] set; }

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
[System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public System.Windows.Input.ICommand Command { get; set; }

[<System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
[<set: System.Security.SecurityCritical>]
member this.Command : System.Windows.Input.ICommand with get, set

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
[<System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
member this.Command : System.Windows.Input.ICommand with get, set

Public Property Command As ICommand

Valor da propriedade

ICommand

O comando associado.

Atributos: TypeConverterAttribute LocalizabilityAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

O valor Command é null.

Exemplos

O exemplo a seguir mostra como usar um KeyBinding para associar um KeyGesture ao comando ApplicationCommands.Open. Quando o gesto de chave é executado, o comando Abrir é invocado.

<Window.InputBindings>
  <KeyBinding Key="B"
              Modifiers="Control" 
              Command="ApplicationCommands.Open" />
</Window.InputBindings>

KeyGesture OpenKeyGesture = new KeyGesture(
    Key.B,
    ModifierKeys.Control);

KeyBinding OpenCmdKeybinding = new KeyBinding(
    ApplicationCommands.Open,
    OpenKeyGesture);

this.InputBindings.Add(OpenCmdKeybinding);

Dim OpenKeyGesture As New KeyGesture(Key.B, ModifierKeys.Control)

Dim OpenCmdKeybinding As New KeyBinding(ApplicationCommands.Open, OpenKeyGesture)

Me.InputBindings.Add(OpenCmdKeybinding)

Comentários

A classe InputBinding não dá suporte ao uso de XAML porque não expõe um construtor público sem parâmetros (ele tem um construtor sem parâmetros, mas está protegido). No entanto, classes derivadas podem expor um construtor público e, portanto, podem usar propriedades herdadas de InputBinding. Duas classes derivadas de InputBinding existentes que podem ser instanciadas em XAML e podem definir propriedades com usos XAML são KeyBinding e MouseBinding.

ICommand faz referência a um conversor de tipo que permite que determinadas implementações de ICommand pré-inicialização especifiquem valores na forma de uma cadeia de caracteres. Esse comportamento de conversão de tipo define a forma de valor de atributo dessa propriedade. Você também pode associar as propriedades Command, CommandParametere CommandTarget a um ICommand definido em um objeto. Isso permite definir um comando personalizado e associá-lo à entrada do usuário. Para obter mais informações, consulte o segundo exemplo em InputBinding.

Uso do atributo XAML

< inputBindingDerivedClass Command="ICommand"/>

Uso do elemento de propriedade XAML

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

Valores XAML

inputBindingDerivedClass
Uma classe derivada de InputBinding que dá suporte à sintaxe do elemento de objeto, como KeyBinding ou MouseBinding. Consulte Comentários.

iCommandImplementation
Uma implementação de objeto de ICommand que dá suporte à sintaxe do elemento de objeto (tem um construtor público sem parâmetros).

Aplica-se a

Partilhar via