InputBinding.CommandParameter Propriedade

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Obtém ou define os dados específicos do comando para um determinado comando.

public:
 property System::Object ^ CommandParameter { System::Object ^ get(); void set(System::Object ^ value); };

public object CommandParameter { get; set; }

member this.CommandParameter : obj with get, set

Public Property CommandParameter As Object

Valor da propriedade

Object

Os dados específicos do comando. O padrão é null.

Comentários

A CommandParameter propriedade é usada para passar informações específicas para o comando quando ela é executada. O tipo dos dados é definido pelo comando . Muitos comandos não esperam parâmetros de comando; para esses comandos, todos os parâmetros de comando passados serão ignorados.

Se o comando ao qual uma associação de entrada está associada for um RoutedCommand, o CommandParameter da associação de entrada será passado para os RoutedCommand manipuladores por meio dos dados de ExecutedRoutedEventArgs evento e CanExecuteRoutedEventArgs quando o comando for processado.

O tipo de dados e a finalidade do parâmetro de comando são definidos de forma diferente para cada comando e podem ser null. Você pode associar as Commandpropriedades , 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.

A InputBinding classe 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 definir propriedades herdadas de com uso de InputBinding XAML. Duas classes derivadas existentes InputBinding que podem ser instanciadas em XAML e podem definir propriedades em XAML são KeyBinding e MouseBinding.

Uso do Atributo XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

Uso do elemento propriedade XAML

<inputBindingDerivedClass>  
  <inputBindingDerivedClass.CommandParameter>  
    <commandParameterObject/>  
  </inputBindingDerivedClass.CommandParameter>  
</inputBindingDerivedClass>  

Valores XAML

inputBindingDerivedClass
Uma classe derivada de InputBinding que dá suporte à sintaxe de elemento de objeto, como KeyBinding ou MouseBinding. Consulte Observações.

commandParameterString
Uma cadeia de caracteres que é processada por um comando específico. Cadeias de caracteres são o tipo comum usado para parâmetros de comando porque podem ser facilmente definidas em XAML. Para o formato de cadeia de caracteres esperado e sua finalidade, consulte a documentação do comando específico ao qual a associação de entrada está associada. Muitos comandos não esperam parâmetros.

commandParameterObject
Um objeto que é processado por um comando específico. Todos os comandos WPF existentes usam cadeias de caracteres. Portanto, essa sintaxe de elemento de propriedade só é relevante para cenários de comando personalizados. Para dar suporte a essa sintaxe, o commandParameterObject objeto também deve dar suporte à sintaxe do elemento de objeto (deve ter um construtor público sem parâmetros).