Bagikan melalui


KeyGesture Kelas

Definisi

Menentukan kombinasi keyboard yang dapat digunakan untuk memanggil perintah.

public ref class KeyGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))>]
type KeyGesture = class
    inherit InputGesture
Public Class KeyGesture
Inherits InputGesture
Warisan
KeyGesture
Atribut

Contoh

Contoh berikut menunjukkan cara mengikat Close perintah ke KeyGesture menggunakan KeyBinding.

KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

KeyBinding CloseKeyBinding = new KeyBinding(
    ApplicationCommands.Close, CloseCmdKeyGesture);

this.InputBindings.Add(CloseKeyBinding);
Dim CloseCmdKeyGesture As New KeyGesture(Key.L, ModifierKeys.Alt)

Dim CloseKeyBinding As New KeyBinding(ApplicationCommands.Close, CloseCmdKeyGesture)

Me.InputBindings.Add(CloseKeyBinding)

Contoh berikut menunjukkan cara menggunakan KeyGesture di XAML. Perhatikan bahwa penggunaan XAML tidak secara langsung mendeklarasikan <KeyGesture> elemen. Penggunaan elemen objek tersebut tidak dimungkinkan karena KeyGesture tidak mengekspos konstruktor tanpa parameter publik. Sebaliknya, penggunaan XAML menggunakan perilaku typeconverter untuk mendeklarasikan seluruh KeyGesture sebaris sebagai Gesture nilai atribut.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>

Keterangan

Dalam kebanyakan kasus, KeyGesture harus dikaitkan dengan satu atau beberapa ModifierKeys. Pengecualian untuk aturan ini adalah kunci fungsi dan kunci keypad numerik, yang dapat menjadi valid KeyGesture sendiri. Misalnya, Anda dapat membuat KeyGesture dengan hanya menggunakan kunci F12, tetapi untuk menggunakan kunci X di dalamnya KeyGesture harus dipasangkan dengan kunci pengubah.

Anda dapat menggunakan KeyBinding untuk mengikat KeyGesture ke ICommand, sehingga perintah dipanggil saat KeyGesture terjadi.

Untuk KeyGesture penggunaan XAML, properti yang umumnya diatur dalam XAML adalah Gesture, dalam kasus di mana gerakan mewakili kunci standar dan kunci pengubah. Anda juga dapat mengatur Gesture properti menjadi hanya kunci fungsi, atau hanya kombinasi tombol pengubah. Namun, lebih umum untuk mengatur Key properti jika pengikatan perintah yang dimaksudkan adalah kunci fungsi tanpa pengubah, atau Modifiers jika pengikatan perintah yang dimaksudkan hanya untuk kunci pengubah.

Penggunaan Atribut XAML

<object property="oneOrMoreModifierKeys+key"/>  
- or -  
<object property="functionKey"/>  

Nilai XAML

functionKey
Key

Nilai kunci tunggal, yang harus merupakan salah satu kunci fungsi (F1-12) atau kunci keypad numerik.

oneOrMoreModifierKeys
Satu atau beberapa kunci pengubah, yang ditentukan oleh ModifierKeys enumerasi, dibatasi dengan karakter "+".

key
Key

Satu nilai kunci.

Konstruktor

KeyGesture(Key)

Menginisialisasi instans KeyGesture baru kelas dengan yang ditentukan Key.

KeyGesture(Key, ModifierKeys)

Menginisialisasi instans KeyGesture baru kelas dengan yang ditentukan Key dan ModifierKeys.

KeyGesture(Key, ModifierKeys, String)

Menginisialisasi instans KeyGesture baru kelas dengan string tampilan , , ModifierKeysdan yang ditentukanKey.

Properti

DisplayString

Mendapatkan representasi string dari ini KeyGesture.

Key

Mendapatkan kunci yang terkait dengan ini KeyGesture.

Modifiers

Mendapatkan kunci pengubah yang terkait dengan ini KeyGesture.

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetDisplayStringForCulture(CultureInfo)

Mengembalikan string yang dapat digunakan untuk menampilkan KeyGesture.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
Matches(Object, InputEventArgs)

Menentukan apakah ini KeyGesture cocok dengan input yang terkait dengan objek yang ditentukan InputEventArgs .

MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga