InputBinding.CommandParameter Eigenschap

Definitie

Hiermee haalt u de opdrachtspecifieke gegevens voor een bepaalde opdracht op of stelt u deze in.

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

Waarde van eigenschap

De opdrachtspecifieke gegevens. De standaardwaarde is null.

Opmerkingen

De CommandParameter eigenschap wordt gebruikt om specifieke informatie door te geven aan de opdracht wanneer deze wordt uitgevoerd. Het type gegevens wordt gedefinieerd door de opdracht. Veel opdrachten verwachten geen opdrachtparameters; voor deze opdrachten worden alle doorgegeven opdrachtparameters genegeerd.

Als de opdracht waaraan een invoerbinding is gekoppeld een RoutedCommandis, wordt de CommandParameter invoerbinding via de handlers doorgegeven aan ExecutedRoutedEventArgs de RoutedCommand handlers en de CanExecuteRoutedEventArgs gebeurtenisgegevens wanneer de opdracht wordt verwerkt.

Het gegevenstype en het doel van de opdrachtparameter worden voor elke opdracht anders gedefinieerd en kunnen zijn null. U kunt de Command, CommandParameteren CommandTarget eigenschappen binden aan een ICommand object dat is gedefinieerd voor een object. Hiermee kunt u een aangepaste opdracht definiëren en deze koppelen aan gebruikersinvoer. Zie voor meer informatie het tweede voorbeeld in InputBinding.

De InputBinding klasse biedt geen ondersteuning voor XAML-gebruik omdat er geen openbare parameterloze constructor wordt weergegeven (deze heeft een parameterloze constructor, maar is beveiligd). Afgeleide klassen kunnen echter een openbare constructor beschikbaar maken en kunnen daarom eigenschappen instellen die worden overgenomen van InputBinding met XAML-gebruik. Twee bestaande InputBinding afgeleide klassen die kunnen worden geïnstantieerd in XAML en eigenschappen kunnen instellen in XAML zijn KeyBinding en MouseBinding.

XAML-kenmerkgebruik

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Gebruik van XAML-eigenschapselement

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

XAML-waarden

inputBindingDerivedClass Een afgeleide klasse van die ondersteuning biedt voor de syntaxis van InputBinding objectelementen, zoals KeyBinding of MouseBinding. Zie opmerkingen.

commandParameterString Een tekenreeks die wordt verwerkt door een bepaalde opdracht. Tekenreeksen zijn het algemene type dat wordt gebruikt voor opdrachtparameters, omdat ze eenvoudig kunnen worden ingesteld in XAML. Zie de documentatie voor de specifieke opdracht waaraan de invoerbinding is gekoppeld voor de verwachte tekenreeksindeling en het doel ervan. Veel opdrachten verwachten geen parameters.

commandParameterObject Een object dat wordt verwerkt door een bepaalde opdracht. Alle bestaande WPF-opdrachten maken gebruik van tekenreeksen. Daarom is deze syntaxis van het eigenschapselement alleen relevant voor aangepaste opdrachtscenario's. Om deze syntaxis te ondersteunen, moet het commandParameterObject object ook de syntaxis van het objectelement ondersteunen (moet een openbare parameterloze constructor hebben).

Van toepassing op