InputBinding.CommandParameter Propriedade

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 de Propriedade

Os dados específicos de comando. A predefinição é null.

Observações

A CommandParameter propriedade é usada para passar informações específicas ao comando quando este é executado. O tipo de dados é definido pelo comando. Muitos comandos não esperam parâmetros de comando; para estes comandos, quaisquer parâmetros de comando passados serão ignorados.

Se o comando a que uma ligação de entrada está associada for a RoutedCommand, a CommandParameter da ligação de entrada é passada aos RoutedCommand manipuladores através dos ExecutedRoutedEventArgs dados do evento e CanExecuteRoutedEventArgs quando o comando é processado.

O tipo de dado e o propósito do parâmetro de comando são definidos de forma diferente para cada comando e podem ser null. Pode associar as Commandpropriedades , CommandParameter, e CommandTarget a um ICommand que está definido num objeto. Isto permite-lhe definir um comando personalizado e associá-lo à entrada do utilizador. Para mais informações, veja o segundo exemplo em InputBinding.

A InputBinding classe não suporta o uso de XAML porque não expõe um construtor público sem parâmetros (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 InputBinding com o uso de XAML. Duas classes derivadas existentes InputBinding que podem ser instanciadas em XAML e que podem definir propriedades em XAML são KeyBinding e MouseBinding.

Uso de atributos XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Uso do elemento de propriedade XAML

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

Valores XAML

inputBindingDerivedClass Uma classe derivada de InputBinding que suporta sintaxe de elementos objeto, como KeyBinding ou MouseBinding. Ver Observações.

commandParameterString Uma cadeia processada por um comando específico. As strings são o tipo comum usado para parâmetros de comando porque podem ser facilmente definidas em XAML. Para o formato de string esperado e o seu propósito, consulte a documentação do comando particular ao qual a ligação de entrada está associada. Muitos comandos não esperam parâmetros.

commandParameterObject Um objeto processado por um comando específico. Todos os comandos WPF existentes usam strings. Portanto, esta sintaxe dos elementos de propriedade é relevante apenas para cenários de comandos personalizados. Para suportar esta sintaxe, o commandParameterObject objeto deve também suportar a sintaxe dos elementos do objeto (deve ter um construtor público sem parámetros).