KeyGesture Třída

Reference

Definice

Obor názvů:: System.Windows.Input

Sestavení:: PresentationCore.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 příkaz 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 použití KeyGesture v XAML. Všimněte si, že použití XAML neeklaruje <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 z tohoto pravidla jsou funkční klávesy a klávesy na numerické klávesnici, které mohou být samy o sobě platné KeyGesture . Můžete například vytvořit KeyGesture pouze klávesu F12, ale pokud chcete použít klávesu X v objektu KeyGesture , musí být spárována s modifikační klávesou.

K vytvoření vazby KeyGesture k objektu KeyBinding ICommandmůžete použít příkaz , aby se příkaz vyvolal při výskytu KeyGesture události .

Pro KeyGesture použití XAML je vlastnost, která je obecně nastavena v XAML, je Gesture, v případech, kdy gesto představuje jak standardní klíč, tak modifikační klíč. Vlastnost můžete také nastavit Gesture tak, aby byla pouze funkční klávesou nebo jen kombinací modifikační klávesy. Vlastnost je však běžnější nastavit Key , pokud je zamýšlenou vazbou příkazu klíč funkce 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, kterou musí být jedna z funkčních kláves (F1-12) nebo kláves na numerické klávesnici.

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

KeyGesture(Key)	Inicializuje novou instanci KeyGesture třídy se zadaným Keyparametrem .
KeyGesture(Key, ModifierKeys)	Inicializuje novou instanci KeyGesture třídy se zadanými Key a ModifierKeys.
KeyGesture(Key, ModifierKeys, String)	Inicializuje novou instanci KeyGesture třídy se zadaným Keyzobrazovaným řetězcem , ModifierKeysa .

Vlastnosti

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

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetDisplayStringForCulture(CultureInfo)	Vrátí řetězec, který lze použít k zobrazení .KeyGesture
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
Matches(Object, InputEventArgs)	Určuje, zda odpovídá KeyGesture vstupu přidruženému k zadanému InputEventArgs objektu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro