InputBinding.CommandParameter Eigenschaft

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Ruft die befehlsspezifischen Daten für einen bestimmten Befehl ab oder legt diese fest.

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

Eigenschaftswert

Object

Die befehlsspezifischen Daten. Der Standardwert ist null.

Hinweise

Die CommandParameter -Eigenschaft wird verwendet, um bestimmte Informationen an den Befehl zu übergeben, wenn er ausgeführt wird. Der Typ der Daten wird durch den Befehl definiert. Viele Befehle erwarten keine Befehlsparameter. Für diese Befehle werden alle übergebenen Befehlsparameter ignoriert.

Wenn der Befehl, dem eine Eingabebindung zugeordnet ist, ein RoutedCommandist, wird der CommandParameter der Eingabebindung an die Handler über die RoutedCommandExecutedRoutedEventArgs - und die CanExecuteRoutedEventArgs Ereignisdaten übergeben, wenn der Befehl verarbeitet wird.

Datentyp und Zweck des Befehlsparameters werden für jeden Befehl unterschiedlich definiert und können sein null. Sie können die CommandEigenschaften , CommandParameterund CommandTarget an ein ICommand binden, das für ein Objekt definiert ist. Dadurch können Sie einen benutzerdefinierten Befehl definieren und der Benutzereingabe zuordnen. Weitere Informationen finden Sie im zweiten Beispiel in InputBinding.

Die InputBinding Klasse unterstützt keine XAML-Verwendung, da sie keinen öffentlichen parameterlosen Konstruktor verfügbar macht (sie verfügt über einen parameterlosen Konstruktor, ist aber geschützt). Abgeleitete Klassen können jedoch einen öffentlichen Konstruktor verfügbar machen und daher Eigenschaften festlegen, die mit XAML-Verwendung geerbt InputBinding werden. Zwei vorhandene InputBinding abgeleitete Klassen, die in XAML instanziiert werden können und Eigenschaften in XAML festlegen können, sind KeyBinding und MouseBinding.

Verwendung von XAML-Attributen

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

Verwendung von XAML-Eigenschaftenelementen

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

XAML-Werte

inputBindingDerivedClass
Eine abgeleitete Klasse von InputBinding , die Objektelementsyntax unterstützt, z KeyBinding . B. oder MouseBinding. Siehe Hinweise.

commandParameterString
Eine Zeichenfolge, die von einem bestimmten Befehl verarbeitet wird. Zeichenfolgen sind der allgemeine Typ, der für Befehlsparameter verwendet wird, da sie problemlos in XAML festgelegt werden können. Informationen zum erwarteten Zeichenfolgenformat und seinem Zweck finden Sie in der Dokumentation für den bestimmten Befehl, dem die Eingabebindung zugeordnet ist. Viele Befehle erwarten keine Parameter.

commandParameterObject
Ein Objekt, das von einem bestimmten Befehl verarbeitet wird. Alle vorhandenen WPF-Befehle verwenden Zeichenfolgen. Daher ist diese Eigenschaftselementsyntax nur für benutzerdefinierte Befehlsszenarien relevant. Um diese Syntax zu unterstützen, muss das Objekt auch die commandParameterObject Objektelementsyntax unterstützen (muss über einen öffentlichen parameterlosen Konstruktor verfügen).