Partager via


Keyboard Classe

Définition

Représente l’appareil clavier.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
Héritage
Keyboard

Exemples

L’exemple suivant montre comment utiliser la IsKeyToggled méthode pour déterminer si une clé est dans l’état bascule. Si le Key passage est IsKeyToggled activé, l’arrière-plan d’un bouton est modifié.

// Uses the Keyboard.IsToggled to determine if a key is toggled.
if (Keyboard.IsKeyToggled(Key.Return))
{
    btnIsToggle.Background = Brushes.Red;
}
else
{
    btnIsToggle.Background = Brushes.AliceBlue;
}
' Uses the Keyboard.IsToggled to determine if a key is toggled.
If Keyboard.IsKeyToggled(Key.Return) Then
    btnIsToggle.Background = Brushes.Red
Else
    btnIsToggle.Background = Brushes.AliceBlue
End If

Remarques

La Keyboard classe fournit des événements, des méthodes et des propriétés liés au clavier qui fournissent des informations sur l’état du clavier.

Chacun des événements qui Keyboard définit comme un événement attaché est également re-exposé par les classes UIElement d’éléments de base et ContentElement en tant qu’événement routé. En règle générale, il est plus pratique de gérer les événements clavier d’une application sur UIElement et ContentElement, plutôt que d’utiliser les Keyboard événements. Pour plus d’informations, consultez Vue d’ensemble de l’entrée.

Pour qu’un élément reçoive l’entrée du clavier, l’élément doit être focusable. La plupart des UIElement objets dérivés sont focusables par défaut. Sinon, pour rendre un élément focusable, définissez la Focusable propriété sur l’élément truede base sur . Pour plus d’informations sur les éléments de base, consultez Vue d’ensemble des éléments de base.

Panel classes, telles que StackPanel et Canvas, définissez la valeur par défaut sur Focusablefalse. Par conséquent, pour que ces objets obtiennent le focus clavier, Focusable doivent être définis sur true.

Le focus clavier fait référence à l’objet qui reçoit l’entrée du clavier. L’élément avec le focus clavier a IsKeyboardFocused la valeur true. Il ne peut y avoir qu’un seul élément avec le focus clavier sur l’ensemble du bureau. Le focus logique fait référence à l’objet dans une étendue de focus qui a le focus. Pour plus d’informations sur le focus, le focus clavier et le focus logique, consultez Vue d’ensemble de l’entrée et Vue d’ensemble du focus.

Les membres statiques du délégué de Keyboard classe au principal KeyboardDevice du thread appelant, de sorte qu’ils ne sont pas nécessairement thread-safe.

Champs

Nom Description
GotKeyboardFocusEvent

Identifie l’événement GotKeyboardFocus attaché.

KeyboardInputProviderAcquireFocusEvent

Identifie l’événement KeyboardInputProviderAcquireFocus attaché.

KeyDownEvent

Identifie l’événement KeyDown attaché.

KeyUpEvent

Identifie l’événement KeyUp attaché.

LostKeyboardFocusEvent

Identifie l’événement LostKeyboardFocus attaché.

PreviewGotKeyboardFocusEvent

Identifie l’événement PreviewGotKeyboardFocus attaché.

PreviewKeyboardInputProviderAcquireFocusEvent

Identifie l’événement PreviewKeyboardInputProviderAcquireFocus attaché.

PreviewKeyDownEvent

Identifie l’événement PreviewKeyDown attaché.

PreviewKeyUpEvent

Identifie l’événement PreviewKeyUp attaché.

PreviewLostKeyboardFocusEvent

Identifie l’événement PreviewLostKeyboardFocus attaché.

Propriétés

Nom Description
DefaultRestoreFocusMode

Obtient ou définit le comportement de Windows Presentation Foundation (WPF) lors de la restauration du focus.

FocusedElement

Obtient l’élément qui a le focus clavier.

Modifiers

Obtient l’ensemble de ModifierKeys ceux qui sont actuellement appuyés.

PrimaryDevice

Obtient l’appareil d’entrée du clavier principal.

Méthodes

Nom Description
AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Ajoute un gestionnaire pour l’événement GotKeyboardFocus attaché.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Ajoute un gestionnaire pour l’événement KeyboardInputProviderAcquireFocus attaché.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Ajoute un gestionnaire pour l’événement KeyDown attaché.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Ajoute un gestionnaire pour l’événement KeyUp attaché.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Ajoute un gestionnaire pour l’événement LostKeyboardFocus attaché.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Ajoute un gestionnaire pour l’événement PreviewGotKeyboardFocus attaché.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Ajoute un gestionnaire pour l’événement PreviewKeyboardInputProviderAcquireFocus attaché.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Ajoute un gestionnaire pour l’événement PreviewKeyDown attaché.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Ajoute un gestionnaire pour l’événement PreviewKeyUp attaché.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Ajoute un gestionnaire pour l’événement PreviewLostKeyboardFocus attaché.

ClearFocus()

Efface le focus.

Focus(IInputElement)

Définit le focus clavier sur l’élément spécifié.

GetKeyStates(Key)

Obtient l’ensemble d’états de clé pour la clé spécifiée.

IsKeyDown(Key)

Détermine si la touche spécifiée est enfoncée.

IsKeyToggled(Key)

Détermine si la clé spécifiée est activée.

IsKeyUp(Key)

Détermine si la clé spécifiée est libérée.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Supprime un gestionnaire pour l’événement GotKeyboardFocus attaché.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Supprime un gestionnaire pour l’événement KeyboardInputProviderAcquireFocus attaché.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Supprime un gestionnaire pour l’événement KeyDown attaché.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Supprime un gestionnaire pour l’événement KeyUp attaché.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Supprime un gestionnaire pour l’événement LostKeyboardFocus attaché.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Supprime un gestionnaire pour l’événement PreviewGotKeyboardFocus attaché.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Supprime un gestionnaire pour l’événement PreviewKeyboardInputProviderAcquireFocus attaché.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Supprime un gestionnaire pour l’événement PreviewKeyDown attaché.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Supprime un gestionnaire pour l’événement PreviewKeyUp attaché.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Supprime un gestionnaire pour l’événement PreviewLostKeyboardFocus attaché.

Événements attachés

Nom Description
GotKeyboardFocus

Se produit lorsqu’un élément reçoit le focus clavier.

KeyboardInputProviderAcquireFocus

Se produit lorsque le fournisseur d’entrée du clavier acquiert le focus.

KeyDown

Se produit lorsqu’une touche du clavier est enfoncée.

KeyUp

Se produit lorsqu’une touche du clavier est libérée.

LostKeyboardFocus

Se produit lorsqu’un élément perd le focus clavier.

PreviewGotKeyboardFocus

Se produit lorsqu’un élément est en train d’acquérir le focus clavier.

PreviewKeyboardInputProviderAcquireFocus

Se produit lorsque le fournisseur d’entrée du clavier est en train d’acquérir le focus.

PreviewKeyDown

Se produit lorsqu’une touche du clavier est enfoncée.

PreviewKeyUp

Se produit lorsqu’une touche du clavier est libérée.

PreviewLostKeyboardFocus

Se produit lorsqu’un élément est en train de perdre le focus clavier.

S’applique à

Voir aussi