InputBinding.CommandParameter Vlastnost

Definice

Obor názvů:

System.Windows.Input

Sestavení:

PresentationCore.dll

Získá nebo nastaví data specifická pro příkaz pro konkrétní příkaz.

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

Hodnota vlastnosti

Object

Data specifická pro příkazy. Výchozí hodnota je null.

Poznámky

Vlastnost CommandParameter se používá k předání konkrétních informací příkazu při jeho spuštění. Typ dat je definován příkazem. Mnoho příkazů neočekává parametry příkazu; pro tyto příkazy budou všechny předané parametry příkazů ignorovány.

Pokud je příkaz, ke kterému je přidružena RoutedCommandvstupní vazba, CommandParameter předá RoutedCommand obslužné rutiny obslužné ExecutedRoutedEventArgs rutiny a CanExecuteRoutedEventArgs data události při zpracování příkazu.

Datový typ a účel parametru příkazu jsou definovány odlišně pro každý příkaz a může být null. Lze vytvořit vazbu , CommandCommandParametera CommandTarget vlastnosti na ICommand objekt, který je definován v objektu. Díky tomu můžete definovat vlastní příkaz a přidružit ho ke vstupu uživatele. Další informace naleznete v druhém příkladu v InputBindingsouboru .

Třída InputBinding nepodporuje použití XAML, protože nezpřístupňuje veřejný konstruktor bez parametrů (má konstruktor bez parametrů, ale je chráněný). Odvozené třídy však mohou vystavit veřejný konstruktor, a proto mohou nastavit vlastnosti, které jsou zděděné z InputBinding použití XAML. Dvě existující InputBinding odvozené třídy, které lze vytvořit instanci v XAML a mohou nastavit vlastnosti v XAML jsou KeyBinding a MouseBinding.

Použití atributu XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Použití elementu vlastnosti XAML

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

Hodnoty XAML

inputBindingDerivedClass Odvozená třída InputBinding , která podporuje syntaxi elementu objektu, například KeyBinding nebo MouseBinding. Viz Poznámky.

commandParameterString Řetězec, který je zpracován konkrétním příkazem. Řetězce jsou běžným typem používaným pro parametry příkazů, protože je možné je snadno nastavit v jazyce XAML. Očekávaný formát řetězce a jeho účel najdete v dokumentaci ke konkrétnímu příkazu, ke kterému je vstupní vazba přidružená. Mnoho příkazů neočekává parametry.

commandParameterObject Objekt, který je zpracován konkrétním příkazem. Všechny existující příkazy WPF používají řetězce. Proto je syntaxe elementu vlastnosti relevantní pouze pro vlastní scénáře příkazů. Aby bylo možné tuto syntaxi podporovat, commandParameterObject musí objekt také podporovat syntaxi elementu objektu (musí mít veřejný konstruktor bez parametrů).