KeyGesture Klass

Definition

Namnområde:
System.Windows.Input
Sammansättning:
PresentationCore.dll

Definierar en tangentbordskombination som kan användas för att anropa ett kommando.

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
Arv
Object
InputGesture
KeyGesture
Attribut
TypeConverterAttribute

Exempel

I följande exempel visas hur du binder Close kommandot till en KeyGesture med hjälp av en 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)

I följande exempel visas hur du använder KeyGesture i XAML. Observera att XAML-användningen inte deklarerar ett <KeyGesture> element direkt. Det går inte att använda objektelementet eftersom KeyGesture det inte exponerar en offentlig parameterlös konstruktor. I stället använder XAML-användningen typeconverter-beteendet för att deklarera en hel KeyGesture infogad som Gesture attributvärde.

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

Kommentarer

I de flesta fall måste en KeyGesture associeras med en eller flera ModifierKeys. Undantagen till den här regeln är funktionsnycklarna och de numeriska knappsatsnycklarna, som kan vara giltiga KeyGesture själva. Du kan till exempel skapa en KeyGesture genom att bara använda F12-nyckeln, men om du vill använda X-nyckeln i en KeyGesture måste den parkopplas med en modifierarnyckel.

Du kan använda a KeyBinding för att binda en KeyGesture till en ICommand, så att kommandot anropas när det KeyGesture inträffar.

För KeyGesture XAML-användningar är Gestureegenskapen som vanligtvis anges i XAML , i de fall där gesten representerar både en standardnyckel och en modifierarnyckel. Du kan också ange Gesture att egenskapen bara ska vara en funktionsnyckel eller bara en kombination av modifierare. Det är dock vanligare att ange Key egenskapen om den avsedda kommandobindningen är en funktionsnyckel utan modifierare, eller Modifiers om den avsedda kommandobindningen endast gäller för modifierarnycklar.

XAML-attributanvändning

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

XAML-värden

functionKey Key

Ett enda nyckelvärde, som måste vara en av funktionsnycklarna (F1-12) eller numeriska tangenter.

oneOrMoreModifierKeys En eller flera modifierarnycklar, definierade av ModifierKeys uppräkningen, avgränsade med ett "+"-tecken.

key Key

Ett enda nyckelvärde.

Konstruktorer

Name Description
KeyGesture(Key, ModifierKeys, String)

Initierar en ny instans av KeyGesture klassen med angiven Key, ModifierKeysoch visningssträng.
KeyGesture(Key, ModifierKeys)

Initierar en ny instans av KeyGesture klassen med angivet Key och ModifierKeys.
KeyGesture(Key)

Initierar en ny instans av KeyGesture klassen med angiven Key.

Egenskaper

Name Description
DisplayString

Hämtar en strängrepresentation av den här KeyGesture.
Key

Hämtar nyckeln som är associerad med den här KeyGesture.
Modifiers

Hämtar de modifierarnycklar som är associerade med den här KeyGesture.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetDisplayStringForCulture(CultureInfo)

Returnerar en sträng som kan användas för att visa KeyGesture.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Matches(Object, InputEventArgs)

Avgör om detta KeyGesture matchar de indata som är associerade med det angivna InputEventArgs objektet.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även