InputBinding.CommandParameter Свойство

Ссылка

Определение

Пространство имен:: System.Windows.Input

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Получает или задает специфические для команды данные для конкретной команды.

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

Значение свойства

Object

Связанные с командой данные. Значение по умолчанию — null.

Свойство CommandParameter используется для передачи определенных сведений команде при ее выполнении. Тип данных определяется командой . Многие команды не ожидают параметров команды; для этих команд все переданные параметры команды будут игнорироваться.

Если команда, с которой связана входная привязка RoutedCommand, является , CommandParameter входная привязка передается обработчикам RoutedCommand через ExecutedRoutedEventArgs CanExecuteRoutedEventArgs и данные события при обработке команды.

Тип данных и назначение параметра команды определяются по-разному для каждой команды и могут иметь значение null. Свойства , CommandParameterи CommandTarget можно привязать Commandк объекту ICommand , определенному в объекте . Это позволяет определить пользовательскую команду и связать ее с введенными пользователем данными. Дополнительные сведения см. во втором примере в InputBinding.

Класс InputBinding не поддерживает использование XAML, так как он не предоставляет открытый конструктор без параметров (у него есть конструктор без параметров, но он защищен). Однако производные классы могут предоставлять открытый конструктор и, следовательно, задавать свойства, унаследованные от InputBinding использования XAML. Два существующих InputBinding производных класса, которые могут создаваться в XAML и задавать свойства в XAML, — это KeyBinding и MouseBinding.

Использование атрибута XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

Использование элемента свойства XAML

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

Значения XAML

inputBindingDerivedClass
Производный класс , InputBinding поддерживающий синтаксис элементов объекта, например KeyBinding или MouseBinding. См. заметки.

commandParameterString
Строка, обрабатываемая определенной командой. Строки являются общим типом, используемым для параметров команд, так как их можно легко задать в XAML. Ожидаемый формат строки и его назначение см. в документации по конкретной команде, с которой связана входная привязка. Многие команды не ожидают параметров.

commandParameterObject
Объект , обрабатываемый определенной командой. Все существующие команды WPF используют строки. Таким образом, этот синтаксис элемента свойства подходит только для пользовательских сценариев команд. Для поддержки этого синтаксиса commandParameterObject объект также должен поддерживать синтаксис элементов объекта (должен иметь открытый конструктор без параметров).

Применяется к