InputBinding.CommandParameter Properti

Definisi

Ruang nama:

System.Windows.Input

Rakitan:

PresentationCore.dll

Mendapatkan atau mengatur data khusus perintah untuk perintah tertentu.

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

Nilai Properti

Object

Data khusus perintah. Default adalah null.

Keterangan

Properti CommandParameter digunakan untuk meneruskan informasi tertentu ke perintah saat dijalankan. Jenis data ditentukan oleh perintah . Banyak perintah tidak mengharapkan parameter perintah; untuk perintah ini, parameter perintah apa pun yang diteruskan akan diabaikan.

Jika perintah yang dikaitkan dengan pengikatan input adalah RoutedCommand, CommandParameter pengikatan input diteruskan ke RoutedCommand handler melalui ExecutedRoutedEventArgs dan CanExecuteRoutedEventArgs data peristiwa saat perintah diproses.

Jenis data dan tujuan parameter perintah didefinisikan secara berbeda untuk setiap perintah dan dapat berupa null. Anda dapat mengikat Commandproperti , CommandParameter, dan CommandTarget ke yang ICommand ditentukan pada objek. Ini memungkinkan Anda menentukan perintah kustom dan mengaitkannya dengan input pengguna. Untuk informasi selengkapnya, lihat contoh kedua di InputBinding.

Kelas InputBinding tidak mendukung penggunaan XAML karena tidak mengekspos konstruktor tanpa parameter publik (memiliki konstruktor tanpa parameter, tetapi dilindungi). Namun, kelas turunan dapat mengekspos konstruktor publik dan oleh karena itu, dapat mengatur properti yang diwarisi dengan InputBinding penggunaan XAML. Dua kelas turunan InputBinding yang ada yang dapat diinstansiasi di XAML dan dapat mengatur properti di XAML adalah KeyBinding dan MouseBinding.

Penggunaan Atribut XAML

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

Penggunaan Elemen Properti XAML

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

Nilai XAML

inputBindingDerivedClass
Kelas turunan InputBinding yang mendukung sintaks elemen objek, seperti KeyBinding atau MouseBinding. Lihat Keterangan.

commandParameterString
String yang diproses oleh perintah tertentu. String adalah jenis umum yang digunakan untuk parameter perintah karena dapat dengan mudah diatur di XAML. Untuk format string yang diharapkan dan tujuannya, lihat dokumentasi untuk perintah tertentu yang dikaitkan dengan pengikatan input. Banyak perintah tidak mengharapkan parameter.

commandParameterObject
Objek yang diproses oleh perintah tertentu. Semua perintah WPF yang ada menggunakan string. Oleh karena itu, sintaks elemen properti ini hanya relevan untuk skenario perintah kustom. Untuk mendukung sintaks ini, commandParameterObject objek juga harus mendukung sintaks elemen objek (harus memiliki konstruktor tanpa parameter publik).