Udostępnij za pośrednictwem

KeyGesture Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Input
Zestaw:
PresentationCore.dll

Definiuje kombinację klawiatury, która może służyć do wywoływania polecenia.

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
Dziedziczenie
Object
InputGesture
KeyGesture
Atrybuty
TypeConverterAttribute

Przykłady

W poniższym przykładzie pokazano, jak powiązać Close polecenie z elementem KeyGesture przy użyciu elementu 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)

W poniższym przykładzie pokazano, jak używać KeyGesture w języku XAML. Należy pamiętać, że użycie języka XAML nie deklaruje <KeyGesture> bezpośrednio elementu. Użycie tego elementu obiektu nie jest możliwe, ponieważ KeyGesture nie uwidacznia publicznego konstruktora bez parametrów. Zamiast tego użycie XAML używa zachowania typeconverter w celu zadeklarowania całej KeyGesture wbudowanej wartości atrybutu Gesture .

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

Uwagi

W większości przypadków element musi być skojarzony z co najmniej jednym ModifierKeyselementem KeyGesture . Wyjątki od tej reguły to klucze funkcji i klucze klawiatury liczbowej, które mogą być prawidłowe KeyGesture samodzielnie. Można na przykład utworzyć KeyGesture obiekt przy użyciu tylko klucza F12, ale aby użyć klucza X w elemecie KeyGesture , musi być sparowany z kluczem modyfikatora.

Można użyć KeyBinding elementu , aby powiązać element z KeyGesture elementem ICommand, aby polecenie było wywoływane w momencie KeyGesture wystąpienia.

W przypadku KeyGesture użycia XAML właściwość, która jest zwykle ustawiana w języku XAML, to Gesture, w przypadkach, gdy gest reprezentuje zarówno klucz standardowy, jak i klucz modyfikatora. Można również ustawić Gesture właściwość jako tylko klucz funkcji lub tylko kombinację klawisza modyfikującego. Jednak częściej ustawia Key się właściwość, jeśli zamierzone powiązanie polecenia jest kluczem funkcji bez modyfikatorów lub Modifiers jeśli zamierzone powiązanie polecenia dotyczy tylko kluczy modyfikujących.

Użycie atrybutu języka XAML

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

Wartości XAML

functionKey
Key

Pojedyncza wartość klucza, która musi być jednym z kluczy funkcji (F1-12) lub numerycznych kluczy klawiatury.

oneOrMoreModifierKeys
Co najmniej jeden klucz modyfikatora, zdefiniowany przez ModifierKeys wyliczenie, rozdzielany znakiem "+".

key
Key

Pojedyncza wartość klucza.

Konstruktory

KeyGesture(Key)

Inicjuje KeyGesture nowe wystąpienie klasy z określonym Keyelementem .
KeyGesture(Key, ModifierKeys)

Inicjuje KeyGesture nowe wystąpienie klasy z określonymi Key parametrami i ModifierKeys.
KeyGesture(Key, ModifierKeys, String)

Inicjuje KeyGesture nowe wystąpienie klasy z określonym Keyciągiem , ModifierKeysi wyświetlanym.

Właściwości

DisplayString

Pobiera reprezentację ciągu tego elementu KeyGesture.
Key

Pobiera klucz skojarzony z tym KeyGestureelementem .
Modifiers

Pobiera klucze modyfikujące skojarzone z tym KeyGestureelementem .

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetDisplayStringForCulture(CultureInfo)

Zwraca ciąg, którego można użyć do wyświetlenia elementu KeyGesture.
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
Matches(Object, InputEventArgs)

Określa, czy jest to KeyGesture zgodne z danymi wejściowymi skojarzonymi z określonym InputEventArgs obiektem.
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też