KeyGesture Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Input

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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