KeyGesture Třída

Definice

Obor názvů:

System.Windows.Input

Sestavení:

PresentationCore.dll

Definuje kombinaci klávesnice, kterou lze použít k vyvolání příkazu.

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

Dědičnost

Object

InputGesture

KeyGesture

Atributy

TypeConverterAttribute

Příklady

Následující příklad ukazuje, jak vytvořit vazbu Close příkazu na KeyGesture pomocí .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)

Následující příklad ukazuje, jak se používá KeyGesture v XAML. Všimněte si, že použití XAML nehlásí <KeyGesture> přímo element. Použití elementu objektu není možné, protože KeyGesture nezpřístupňuje veřejný konstruktor bez parametrů. Místo toho použití XAML používá chování typeconverter deklarovat celý KeyGesture vložený jako hodnotu atributu Gesture .

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

Poznámky

Ve většině případů musí být přidružena KeyGesture k jednomu nebo více ModifierKeys. Výjimkou tohoto pravidla jsou funkční klávesy a numerické klávesy klávesnice, které mohou být samy o sobě platné KeyGesture . Můžete například vytvořit KeyGesture pouze pomocí klíče F12, ale pokud chcete použít klíč X v KeyGesture klíči, musí být spárovaný s modifikačním klíčem.

Můžete použít KeyBinding k vytvoření vazby k objektu ICommandKeyGesture , aby byl příkaz vyvolán při výskytuKeyGesture.

Pro KeyGesture použití XAML je vlastnost, která je obecně nastavena v XAML , Gesturev případech, kdy gesto představuje standardní klíč i modifikační klíč. Vlastnost můžete také nastavit Gesture tak, aby byla jen funkční klávesa, nebo jen modifikační kombinace kláves. Je však častější nastavit Key vlastnost, pokud zamýšlená vazba příkazu je funkční klíč bez modifikátorů, nebo Modifiers pokud je zamýšlená vazba příkazu pouze pro modifikační klávesy.

Použití atributu XAML

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

Hodnoty XAML

functionKey Key

Jedna hodnota klíče, která musí být jednou z funkčních kláves (F1-12) nebo číselných klávesových kláves.

oneOrMoreModifierKeys Jeden nebo více modifikačních klíčů definovaných ModifierKeys výčtem oddělených znakem "+".

key Key

Jedna hodnota klíče.

Konstruktory

Name	Description
KeyGesture(Key, ModifierKeys, String)	Inicializuje novou instanci KeyGesture třídy se zadaným Key, ModifierKeysa zobrazit řetězec.
KeyGesture(Key, ModifierKeys)	Inicializuje novou instanci KeyGesture třídy se zadaným Key a ModifierKeys.
KeyGesture(Key)	Inicializuje novou instanci KeyGesture třídy se zadaným Key.

Vlastnosti

Name	Description
DisplayString	Získá řetězcovou reprezentaci tohoto KeyGesture.
Key	Získá klíč přidružený k tomuto KeyGesture.
Modifiers	Získá modifikační klíče přidružené k tomuto KeyGesture.

Metody

Name	Description
GetDisplayStringForCulture(CultureInfo)	Vrátí řetězec, který lze použít k zobrazení KeyGesture.
Matches(Object, InputEventArgs)	Určuje, zda odpovídá KeyGesture vstupu přidruženému k zadanému InputEventArgs objektu.

Viz také

• KeyBinding
• MouseBinding
• RoutedCommand
• CommandBinding
• MouseGesture
• InputBinding
• InputGesture