Keyboard Classe

Définition

Représente le périphérique 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 à l’état basculé. Si le Key passé à IsKeyToggled est 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 définis en tant qu’événement Keyboard attaché est également ré-exposé par les classes UIElement d’éléments de base et ContentElement en tant que nouvel événement routé. En règle générale, il est plus pratique de gérer les événements de clavier pour une application sur UIElement et ContentElement, plutôt que d’utiliser les Keyboard événements. Pour plus d’informations, consultez Vue d’ensemble des entrées.

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

Panel les classes, telles que StackPanel et Canvas, définissent la valeur par défaut de Focusable sur false. Par conséquent, pour que ces objets obtiennent le focus clavier, Focusable doit être défini sur true.

Le focus clavier fait référence à l’objet qui reçoit une entrée au 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 des entrées et Vue d’ensemble du focus.

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

Champs

GotKeyboardFocusEvent

Identifie l’événement attaché GotKeyboardFocus.

KeyboardInputProviderAcquireFocusEvent

Identifie l’événement attaché KeyboardInputProviderAcquireFocus.

KeyDownEvent

Identifie l’événement attaché KeyDown.

KeyUpEvent

Identifie l’événement attaché KeyUp.

LostKeyboardFocusEvent

Identifie l’événement attaché LostKeyboardFocus.

PreviewGotKeyboardFocusEvent

Identifie l’événement attaché PreviewGotKeyboardFocus.

PreviewKeyboardInputProviderAcquireFocusEvent

Identifie l’événement attaché PreviewKeyboardInputProviderAcquireFocus.

PreviewKeyDownEvent

Identifie l’événement attaché PreviewKeyDown.

PreviewKeyUpEvent

Identifie l’événement attaché PreviewKeyUp.

PreviewLostKeyboardFocusEvent

Identifie l’événement attaché PreviewLostKeyboardFocus.

Propriétés

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 qui est actuellement enfoncé.

PrimaryDevice

Obtient le périphérique d'entrée au clavier principal.

Méthodes

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

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

AddKeyDownHandler(DependencyObject, KeyEventHandler)

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

AddKeyUpHandler(DependencyObject, KeyEventHandler)

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

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

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

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

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

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

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

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

ClearFocus()

Efface le focus.

Focus(IInputElement)

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

GetKeyStates(Key)

Obtient l'ensemble des états de touche pour la touche spécifiée.

IsKeyDown(Key)

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

IsKeyToggled(Key)

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

IsKeyUp(Key)

Détermine si la touche spécifiée est relâchée.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

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

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

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

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

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

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

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

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

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

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

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

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

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

Événements attachés

GotKeyboardFocus

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

KeyboardInputProviderAcquireFocus

Se produit lorsque le fournisseur d'entrées au clavier acquiert le focus.

KeyDown

Se produit quand l’utilisateur appuie sur une touche du clavier.

KeyUp

Se produit quand l’utilisateur relâche une touche du clavier.

LostKeyboardFocus

Se produit quand un élément perd le focus clavier.

PreviewGotKeyboardFocus

Se produit quand un élément est sur le point d’acquérir le focus clavier.

PreviewKeyboardInputProviderAcquireFocus

Se produit lorsque le fournisseur d'entrées au clavier est en cours d'acquisition du focus.

PreviewKeyDown

Se produit quand l’utilisateur appuie sur une touche du clavier.

PreviewKeyUp

Se produit quand l’utilisateur relâche une touche du clavier.

PreviewLostKeyboardFocus

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

S’applique à

Voir aussi