KeyGesture Osztály

Definíció

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
KeyGesture
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)

A következőre érvényes:

Lásd még