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则当处理命令时，输入绑定将通过处理程序和CanExecuteRoutedEventArgs事件数据传递给RoutedCommand处理程序ExecutedRoutedEventArgs。

命令参数的数据类型和用途因每个命令而定义不同，并且可以是 null。 可以将和Command属性绑定到ICommand对象上定义的属性CommandParameterCommandTarget。 这使你可以定义自定义命令并将其与用户输入相关联。 有关详细信息，请参阅第二个示例。InputBinding

该 InputBinding 类不支持 XAML 用法，因为它不公开公共无参数构造函数（它具有无参数构造函数，但它受到保护）。 但是，派生类可以公开公共构造函数，因此，可以设置从 InputBinding XAML 用法继承的属性。 可以在 XAML 中实例化的两个现有InputBinding派生类，并且可以在 XAML 中设置属性。KeyBindingMouseBinding

XAML 属性用法

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

XAML 属性元素用法

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

XAML 值

inputBindingDerivedClass 支持对象元素语法的派生类 InputBinding ，例如 KeyBinding 或 MouseBinding。 请参阅注解。

commandParameterString 由特定命令处理的字符串。 字符串是用于命令参数的常见类型，因为它们可以在 XAML 中轻松设置。 有关预期的字符串格式及其用途，请参阅与输入绑定关联的特定命令的文档。 许多命令不需要参数。

commandParameterObject 由特定命令处理的对象。 所有现有的 WPF 命令都使用字符串。 因此，此属性元素语法仅适用于自定义命令方案。 为了支持此语法，该 commandParameterObject 对象还必须支持对象元素语法（必须具有公共无参数构造函数）。