InputBinding.CommandParameter Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает специфические для команды данные для конкретной команды.
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
Значение свойства
Связанные с командой данные. Значение по умолчанию — null
.
Комментарии
Свойство CommandParameter используется для передачи определенных сведений команде при ее выполнении. Тип данных определяется командой . Многие команды не ожидают параметров команды; для этих команд все переданные параметры команды будут игнорироваться.
Если команда, с которой связана входная привязка RoutedCommand, является , CommandParameter входная привязка передается обработчикам RoutedCommand через ExecutedRoutedEventArgsCanExecuteRoutedEventArgs и данные события при обработке команды.
Тип данных и назначение параметра команды определяются по-разному для каждой команды и могут иметь значение 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
объект также должен поддерживать синтаксис элементов объекта (должен иметь открытый конструктор без параметров).