InputBinding.CommandParameter Tulajdonság

Definíció

Névtér:

System.Windows.Input

Szerelvény:

PresentationCore.dll

Lekéri vagy beállítja egy adott parancs parancsspecifikus adatait.

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

Tulajdonság értéke

Object

A parancsspecifikus adatok. Az alapértelmezett érték a null.

Megjegyzések

A CommandParameter tulajdonságot arra használjuk, hogy adott információkat adjon át a parancsnak a végrehajtáskor. Az adatok típusát a parancs határozza meg. Sok parancs nem vár parancsparamétereket; ezen parancsok esetében a rendszer figyelmen kívül hagyja az átadott parancsparamétereket.

Ha az a parancs, amelyhez egy bemeneti kötés társítva vanRoutedCommand, a CommandParameter bemeneti kötést a rendszer a parancs feldolgozásakor az RoutedCommand eseményadatokon ExecutedRoutedEventArgs keresztül továbbítja CanExecuteRoutedEventArgs a kezelőknek.

A parancsparaméter adattípusa és rendeltetése az egyes parancsok esetében eltérően van meghatározva, és lehet null. Az objektumon definiált Command objektumokhoz kötheti a CommandParameter, CommandTargetés ICommand a tulajdonságokat. Ez lehetővé teszi egy egyéni parancs definiálásához és a felhasználói bemenethez való társításához. További információ: a második példa a InputBinding.

Az InputBinding osztály nem támogatja az XAML használatát, mert nem tesz közzé nyilvános paraméter nélküli konstruktort (paraméter nélküli konstruktort tartalmaz, de védett). A származtatott osztályok azonban közzétehetnek egy nyilvános konstruktort, ezért beállíthatnak olyan tulajdonságokat, amelyek az XAML-használattól InputBinding öröklődnek. Két meglévő InputBinding származtatott osztály, amelyek az XAML-ben példányosíthatók, és az XAML-ben KeyBinding megadhatók a tulajdonságok.MouseBinding

XAML-attribútumok használata

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

XAML tulajdonságelem-használat

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

XAML-értékek

inputBindingDerivedClass Olyan származtatott osztály, amely támogatja az InputBinding objektumelem szintaxisát, például KeyBinding vagy MouseBinding. Lásd: Megjegyzések.

commandParameterString Egy adott parancs által feldolgozott sztring. A sztringek a parancsparaméterek gyakori típusa, mivel könnyen beállíthatók az XAML-ben. A várt sztringformátumot és annak célját a bemeneti kötéssel társított adott parancs dokumentációjában találja. Sok parancs nem vár paramétereket.

commandParameterObject Egy adott parancs által feldolgozott objektum. Minden meglévő WPF parancs sztringeket használ. Ezért ez a tulajdonságelem szintaxisa csak egyéni parancsforgatókönyvekben releváns. A szintaxis támogatásához az objektumnak támogatnia kell az commandParameterObject objektumelem szintaxisát is (nyilvános paraméter nélküli konstruktorsal kell rendelkeznie).