Keyboard Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
É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. |