Condividi tramite


InputBinding.CommandParameter Proprietà

Definizione

Ottiene o imposta i dati specifici del comando per un comando specifico.

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à

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 è RoutedCommand, l'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 di 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 che possono essere create un'istanza in XAML e possono impostare le proprietà in XAML sono KeyBinding e MouseBinding.

Utilizzo degli attributi XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Utilizzo dell'elemento della proprietà XAML

<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 le Note.

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 relativa al 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 comandi personalizzati. Per supportare questa sintassi, l'oggetto deve supportare anche la commandParameterObject sintassi degli elementi oggetto (deve avere un costruttore pubblico senza parametri).

Si applica a