KeyGesture Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A parancsok meghívásához használható billentyűzetkombinációt definiál.
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
- Öröklődés
- Attribútumok
Példák
Az alábbi példa bemutatja, hogyan kötheti a Close parancsot egy KeyGestureKeyBinding felhasználóhoz.
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)
Az alábbi példa bemutatja, hogyan használható KeyGesture az XAML-ben. Vegye figyelembe, hogy az XAML-használat nem deklarál közvetlenül egy <KeyGesture> elemet. Ez az objektumelem-használat nem lehetséges, mert KeyGesture nem tesz közzé nyilvános paraméter nélküli konstruktort. Ehelyett az XAML-használat a typeconverter viselkedésével deklarál egy teljes KeyGesture beágyazott értéket attribútumértékként Gesture .
<Window.InputBindings>
<KeyBinding Command="ApplicationCommands.Open"
Gesture="CTRL+R" />
</Window.InputBindings>
Megjegyzések
A legtöbb esetben egy KeyGesture vagy többhöz ModifierKeyskell társítani. A szabály alól kivételt képeznek a függvénykulcsok és a numerikus billentyűzetkulcsok, amelyek önmagukban is érvényesek KeyGesture lehetnek. Létrehozhat például egy KeyGesture fájlt csak az F12 billentyűvel, de ha az X kulcsot KeyGesture egy módosító kulccsal szeretné használni, akkor azt egy módosító kulccsal kell párosítani.
Az a KeyBinding paranccsal köthet egy KeyGesture parancsot egyhezICommand, így a parancs meghívása megtörténik.KeyGesture
KeyGesture XAML-használat esetén az XAML-ben általában beállított tulajdonság azGesture, ha a kézmozdulat egy standard és egy módosító kulcsot is jelöl. Azt is beállíthatja, hogy a Gesture tulajdonság csak egy függvénykulcs, vagy csak egy módosítókulcs-kombináció legyen. Gyakoribb azonban a Key tulajdonság beállítása, ha a kívánt parancskötés egy módosító nélküli függvénykulcs, vagy Modifiers ha a kívánt parancskötés csak módosító kulcsokra vonatkozik.
XAML-attribútumok használata
<object property="oneOrMoreModifierKeys+key"/>
- or -
<object property="functionKey"/>
XAML-értékek
functionKey
Key
Egyetlen kulcsérték, amelynek a függvénykulcsok (F1-12) vagy a numerikus billentyűzetkulcsok egyikének kell lennie.
oneOrMoreModifierKeys Egy vagy több módosító kulcs, amelyet az ModifierKeys enumerálás határoz meg, "+" karakterrel elválasztva.
key
Key
Egyetlen kulcsérték.
Konstruktorok
| Name | Description |
|---|---|
| KeyGesture(Key, ModifierKeys, String) |
Inicializálja az osztály új példányát KeyGesture a megadott Key, ModifierKeysés megjelenítendő sztringgel. |
| KeyGesture(Key, ModifierKeys) |
Inicializálja az osztály új példányát a KeyGesture megadott Key és ModifierKeysa . |
| KeyGesture(Key) |
Inicializálja az osztály új példányát KeyGesture a megadott Key. |
Tulajdonságok
| Name | Description |
|---|---|
| DisplayString |
Lekéri ennek KeyGesturea sztring-ábrázolását. |
| Key |
Lekéri a hozzá társított KeyGesturekulcsot. |
| Modifiers |
Lekéri a hozzá társított KeyGesturemódosítókulcsokat. |
Metódusok
| Name | Description |
|---|---|
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetDisplayStringForCulture(CultureInfo) |
Egy sztringet ad vissza, amellyel megjeleníthető a KeyGesture. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| Matches(Object, InputEventArgs) |
Meghatározza, hogy ez KeyGesture megfelel-e a megadott InputEventArgs objektumhoz társított bemenetnek. |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |