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 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
É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. |