InputBinding.CommandParameter Proprietà

Definizione

Spazio dei nomi:

System.Windows.Input

Assembly:

PresentationCore.dll

Ottiene o imposta i dati specifici del comando per un particolare 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

Valore della proprietà

Object

Dati specifici del comando. Il valore predefinito è null.

Commenti

La CommandParameter proprietà viene utilizzata per passare informazioni specifiche al comando quando viene eseguito. Il tipo di dati è definito dal comando . Molti comandi non prevedono parametri di comando; per questi comandi, tutti i parametri di comando passati verranno ignorati.

Se il comando a cui è associato un'associazione di input è , RoutedCommandl'oggetto CommandParameter dell'associazione di input viene passato ai RoutedCommand gestori tramite ExecutedRoutedEventArgs e i CanExecuteRoutedEventArgs dati dell'evento durante l'elaborazione del comando.

Il tipo di dati e lo scopo del parametro di comando sono definiti in modo diverso per ogni comando e possono essere null. È possibile associare le Commandproprietà , CommandParametere CommandTarget a un oggetto ICommand definito in un oggetto . In questo modo è possibile definire un comando personalizzato e associarlo all'input dell'utente. Per altre informazioni, vedere il secondo esempio in InputBinding.

La InputBinding classe non supporta l'utilizzo xaml perché non espone un costruttore pubblico senza parametri (ha un costruttore senza parametri, ma è protetto). Tuttavia, le classi derivate possono esporre un costruttore pubblico e pertanto possono impostare proprietà ereditate da InputBinding con l'utilizzo XAML. Due classi derivate esistenti InputBinding di cui è possibile creare un'istanza in XAML e possono impostare le proprietà in XAML sono KeyBinding e MouseBinding.

Uso della sintassi XAML per gli attributi

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

Utilizzo della sintassi XAML per elementi proprietà

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

Valori XAML

inputBindingDerivedClass
Classe derivata di che supporta la sintassi degli InputBinding elementi oggetto, ad esempio KeyBinding o MouseBinding. Vedere la sezione Osservazioni.

commandParameterString
Stringa elaborata da un comando specifico. Le stringhe sono il tipo comune usato per i parametri di comando perché possono essere facilmente impostati in XAML. Per il formato di stringa previsto e il relativo scopo, vedere la documentazione per il comando specifico a cui è associata l'associazione di input. Molti comandi non prevedono parametri.

commandParameterObject
Oggetto elaborato da un comando specifico. Tutti i comandi WPF esistenti usano stringhe. Pertanto, questa sintassi degli elementi di proprietà è rilevante solo per gli scenari di comando personalizzati. Per supportare questa sintassi, l'oggetto deve supportare anche la commandParameterObject sintassi degli elementi oggetto (deve avere un costruttore pubblico senza parametri).