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則當處理命令時，輸入系結的 會傳遞ExecutedRoutedEventArgs至RoutedCommand處理程式和CanExecuteRoutedEventArgs事件數據。

命令參數的數據類型和用途會針對每個命令以不同的方式定義，而且可以是 null。 您可以將、 CommandParameter屬性 CommandTarget 系結Command到 ICommand 物件上定義的 。 這可讓您定義自定義命令，並將其與使用者輸入產生關聯。 如需詳細資訊，請參閱 中的第二個 InputBinding範例。

類別 InputBinding 不支援 XAML 使用方式，因為它不會公開公用無參數建構函式， (它具有無參數建構函式，但受到保護) 。 不過，衍生類別可以公開公用建構函式，因此可以設定使用 XAML 使用方式繼承自 InputBinding 的屬性。 兩個可以在 XAML 中具現化的現有 InputBinding 衍生類別，而且可以在 XAML 中設定屬性為 KeyBinding 和 MouseBinding。

XAML Attribute Usage

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

XAML 屬性項目用法

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

XAML 值

inputBindingDerivedClass
的衍生類別 InputBinding ，支援物件項目語法，例如 KeyBinding 或 MouseBinding。 請參閱＜備註＞。

commandParameterString
由特定命令處理的字串。 字串是命令參數常用的類型，因為它們可以輕鬆地在 XAML 中設定。 如需預期的字串格式及其用途，請參閱與輸入系結相關聯之特定命令的檔。 許多命令都不需要參數。

commandParameterObject
由特定命令處理的物件。 所有現有的 WPF 命令都會使用字串。 因此，這個屬性元素語法只與自定義命令案例相關。 為了支援此語法， commandParameterObject 對象也必須支援對象元素語法， (必須具有公用無參數建構函式) 。