InputBinding.CommandParameter Propriété

Référence

Définition

Espace de noms:: System.Windows.Input

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit les données spécifiques à la commande pour une commande particulière.

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é

Object

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

Remarques

La CommandParameter propriété est utilisée pour passer des informations spécifiques à la commande lors de son exécution. 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, le CommandParameter de la liaison d’entrée est passé aux gestionnaires par le RoutedCommand biais des 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 Commandpropriétés , CommandParameteret CommandTarget à un ICommand qui est défini sur un objet. Cela vous permet de définir une commande personnalisée et de l’associer à une entrée utilisateur. Pour plus d’informations, consultez le deuxième exemple dans InputBinding.

La InputBinding classe ne prend pas en charge l’utilisation de 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, peuvent définir des propriétés héritées de l’utilisation XAML InputBinding . Deux classes dérivées existantes InputBinding qui peuvent être instanciées en XAML et qui peuvent définir des propriétés dans XAML sont KeyBinding et MouseBinding.

Utilisation d'attributs XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Utilisation des éléments de propriété XAML

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

Valeurs XAML

inputBindingDerivedClass
Classe dérivée de qui prend en charge la syntaxe d’élément InputBinding d’objet, telle que KeyBinding ou MouseBinding. Consultez la section Notes.

commandParameterString
Chaîne traitée par une commande particulière. Les chaînes sont le type couramment utilisé pour les paramètres de commande, car elles peuvent être facilement définies en XAML. Pour connaître 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 n’attendent pas de 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 commandes personnalisées. Pour prendre en charge cette syntaxe, l’objet doit également prendre en charge la commandParameterObject syntaxe de l’élément objet (doit avoir un constructeur sans paramètre public).

S’applique à

Partage via