InputBinding.CommandParameter Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Input

Zestaw:

PresentationCore.dll

Pobiera lub ustawia dane specyficzne dla polecenia dla określonego polecenia.

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

Wartość właściwości

Object

Dane specyficzne dla polecenia. Wartość domyślna to null.

Uwagi

Właściwość CommandParameter służy do przekazywania określonych informacji do polecenia po jego wykonaniu. Typ danych jest definiowany przez polecenie . Wiele poleceń nie oczekuje parametrów polecenia; dla tych poleceń wszystkie przekazane parametry polecenia zostaną zignorowane.

Jeśli polecenie skojarzone z powiązaniem wejściowym jest elementem RoutedCommand, CommandParameter powiązanie wejściowe jest przekazywane do RoutedCommand procedur obsługi za pośrednictwem ExecutedRoutedEventArgs danych i CanExecuteRoutedEventArgs zdarzenia podczas przetwarzania polecenia.

Typ danych i przeznaczenie parametru polecenia są definiowane inaczej dla każdego polecenia i może to być null. Właściwości , CommandParameteri CommandTarget można powiązać Commandz obiektem ICommand zdefiniowanym w obiekcie. Dzięki temu można zdefiniować niestandardowe polecenie i skojarzyć je z danymi wejściowymi użytkownika. Aby uzyskać więcej informacji, zobacz drugi przykład w InputBindingpliku .

Klasa InputBinding nie obsługuje użycia języka XAML, ponieważ nie uwidacznia publicznego konstruktora bez parametrów (ma konstruktor bez parametrów, ale jest chroniony). Jednak klasy pochodne mogą uwidocznić publiczny konstruktor i dlatego mogą ustawiać właściwości dziedziczone z InputBinding użyciem języka XAML. Dwie istniejące InputBinding klasy pochodne, które można utworzyć w języku XAML i mogą ustawiać właściwości w języku XAML, to KeyBinding i MouseBinding.

Użycie atrybutu języka XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

Użycie elementu właściwości języka XAML

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

Wartości XAML

inputBindingDerivedClass
Klasa pochodna, która InputBinding obsługuje składnię elementu obiektu, taką jak KeyBinding lub MouseBinding. Zobacz uwagi.

commandParameterString
Ciąg przetwarzany przez określone polecenie. Ciągi są typowym typem używanym dla parametrów polecenia, ponieważ można je łatwo ustawić w języku XAML. Aby uzyskać oczekiwany format ciągu i jego przeznaczenie, zapoznaj się z dokumentacją konkretnego polecenia, z którą jest skojarzone powiązanie wejściowe. Wiele poleceń nie oczekuje parametrów.

commandParameterObject
Obiekt przetwarzany przez określone polecenie. Wszystkie istniejące polecenia WPF używają ciągów. W związku z tym ta składnia elementu właściwości jest odpowiednia tylko w przypadku scenariuszy poleceń niestandardowych. Aby obsługiwać tę składnię, commandParameterObject obiekt musi również obsługiwać składnię elementu obiektu (musi mieć publiczny konstruktor bez parametrów).