InputBinding.CommandParameter Propriété

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

Valeur de propriété

Données spécifiques à la commande. La valeur par défaut est null.

Remarques

La CommandParameter propriété est utilisée pour transmettre des informations spécifiques à la commande lorsqu’elle est exécutée. Le type des données est défini par la commande. De nombreuses commandes ne s’attendent pas à des paramètres de commande ; pour ces commandes, tous les paramètres de commande passés sont ignorés.

Si la commande à laquelle une liaison d’entrée est associée est un RoutedCommand, la CommandParameter liaison d’entrée est transmise aux RoutedCommand gestionnaires via les ExecutedRoutedEventArgs données d’événement et CanExecuteRoutedEventArgs lors du traitement de la commande.

Le type de données et l’objectif du paramètre de commande sont définis différemment pour chaque commande et peuvent être null. Vous pouvez lier les propriétés et CommandParameterCommandTarget les Commandpropriétés à un ICommand objet défini sur un objet. Cela vous permet de définir une commande personnalisée et de l’associer à l’entrée utilisateur. Pour plus d’informations, consultez le deuxième exemple dans InputBinding.

La classe ne prend pas en charge l’utilisation InputBinding XAML, car elle n’expose pas de constructeur sans paramètre public (elle a un constructeur sans paramètre, mais elle est protégée). Toutefois, les classes dérivées peuvent exposer un constructeur public et, par conséquent, définir des propriétés héritées de l’utilisation InputBinding XAML. Deux classes dérivées existantes InputBinding qui peuvent être instanciées en XAML et qui peuvent définir des propriétés en XAML sont KeyBinding et MouseBinding.

Utilisation des attributs XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Utilisation de l’élément de propriété XAML

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

Valeurs XAML

inputBindingDerivedClass Classe dérivée de celle-ci prend en charge la syntaxe d’élément InputBinding objet, telle que KeyBinding ou MouseBinding. Voir les remarques.

commandParameterString Chaîne traitée par une commande particulière. Les chaînes sont le type courant utilisé pour les paramètres de commande, car ils peuvent être facilement définis en XAML. Pour le format de chaîne attendu et son objectif, consultez la documentation relative à la commande particulière à laquelle la liaison d’entrée est associée. De nombreuses commandes ne s’attendent pas à des paramètres.

commandParameterObject Objet traité par une commande particulière. Toutes les commandes WPF existantes utilisent des chaînes. Par conséquent, cette syntaxe d’élément de propriété n’est pertinente que pour les scénarios de commande personnalisés. Pour prendre en charge cette syntaxe, l’objet commandParameterObject doit également prendre en charge la syntaxe d’élément d’objet (doit avoir un constructeur sans paramètre public).