Keyboard Classe

Definição

Representa o dispositivo de teclado.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
Herança
Keyboard

Exemplos

O exemplo a seguir mostra como usar o IsKeyToggled método para determinar se uma chave está no estado alternado. Se o Key passado para IsKeyToggled for alternado, a tela de fundo de um botão será alterada.

// 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

Comentários

A Keyboard classe fornece eventos, métodos e propriedades relacionados ao teclado que fornecem informações sobre o estado do teclado.

Cada um dos eventos que Keyboard define como um evento anexado também é exposto novamente pelas classes UIElement de elemento base e ContentElement como um novo evento roteado. Geralmente, é mais conveniente manipular eventos de teclado para um aplicativo em UIElement e ContentElement, em vez de usar os Keyboard eventos. Para obter detalhes, consulte Visão geral da entrada.

Para que um elemento receba entrada de teclado, o elemento deve ser focalizável. A maioria dos UIElement objetos derivados é focalizável por padrão. Caso contrário, para tornar um elemento focalizável, defina a Focusable propriedade no elemento base como true. Para obter mais informações sobre os elementos base, consulte Visão geral dos elementos base.

Panel classes, como StackPanel e Canvas, definem o valor padrão de Focusable como false. Portanto, para que esses objetos obtenham o foco do teclado, Focusable deve ser definido como true.

O foco do teclado refere-se ao objeto que está recebendo entrada de teclado. O elemento com foco no teclado foi IsKeyboardFocused definido como true. Só pode haver um elemento com foco no teclado em toda a área de trabalho. O foco lógico refere-se ao objeto dentro de um escopo de foco que tem foco. Para obter mais informações sobre foco, foco do teclado e foco lógico, consulte Visão geral de entrada e Visão geral do foco.

Os membros estáticos do Keyboard delegado de classe para o primário KeyboardDevice do thread de chamada, portanto, eles não são necessariamente thread-safe.

Campos

GotKeyboardFocusEvent

Identifica o evento GotKeyboardFocus anexado.

KeyboardInputProviderAcquireFocusEvent

Identifica o evento KeyboardInputProviderAcquireFocus anexado.

KeyDownEvent

Identifica o evento KeyDown anexado.

KeyUpEvent

Identifica o evento KeyUp anexado.

LostKeyboardFocusEvent

Identifica o evento LostKeyboardFocus anexado.

PreviewGotKeyboardFocusEvent

Identifica o evento PreviewGotKeyboardFocus anexado.

PreviewKeyboardInputProviderAcquireFocusEvent

Identifica o evento PreviewKeyboardInputProviderAcquireFocus anexado.

PreviewKeyDownEvent

Identifica o evento PreviewKeyDown anexado.

PreviewKeyUpEvent

Identifica o evento PreviewKeyUp anexado.

PreviewLostKeyboardFocusEvent

Identifica o evento PreviewLostKeyboardFocus anexado.

Propriedades

DefaultRestoreFocusMode

Obtém ou define o comportamento de Windows Presentation Foundation (WPF) ao restaurar o foco.

FocusedElement

Obtém o elemento que tem o foco do teclado.

Modifiers

Obtém o conjunto de ModifierKeys pressionadas no momento.

PrimaryDevice

Obtém o dispositivo de entrada do teclado primário.

Métodos

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um manipulador ao evento anexado GotKeyboardFocus.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Adiciona um manipulador ao evento anexado KeyboardInputProviderAcquireFocus.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Adiciona um manipulador ao evento anexado KeyDown.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Adiciona um manipulador ao evento anexado KeyUp.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um manipulador ao evento anexado LostKeyboardFocus.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um manipulador ao evento anexado PreviewGotKeyboardFocus.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Adiciona um manipulador ao evento anexado PreviewKeyboardInputProviderAcquireFocus.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Adiciona um manipulador ao evento anexado PreviewKeyDown.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Adiciona um manipulador ao evento anexado PreviewKeyUp.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um manipulador ao evento anexado PreviewLostKeyboardFocus.

ClearFocus()

Limpa o foco.

Focus(IInputElement)

Determina o foco do teclado no elemento especificado.

GetKeyStates(Key)

Obtém o conjunto de estados principais para a chave especificada.

IsKeyDown(Key)

Determina se a tecla especificada está pressionada.

IsKeyToggled(Key)

Determina se a tecla especificada está ativada.

IsKeyUp(Key)

Determina se a tecla especificada está solta.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um manipulador para o evento anexado GotKeyboardFocus.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Remove um manipulador para o evento anexado KeyboardInputProviderAcquireFocus.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Remove um manipulador para o evento anexado KeyDown.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Remove um manipulador para o evento anexado KeyUp.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um manipulador para o evento anexado LostKeyboardFocus.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um manipulador para o evento anexado PreviewGotKeyboardFocus.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Remove um manipulador para o evento anexado PreviewKeyboardInputProviderAcquireFocus.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Remove um manipulador para o evento anexado PreviewKeyDown.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Remove um manipulador para o evento anexado PreviewKeyUp.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um manipulador para o evento anexado PreviewLostKeyboardFocus.

Eventos Anexados

GotKeyboardFocus

Ocorre quando um elemento recebe o foco do teclado.

KeyboardInputProviderAcquireFocus

Ocorre quando o provedor de entrada do teclado fica com o foco.

KeyDown

Ocorre quando uma tecla do teclado é pressionada.

KeyUp

Ocorre quando uma tecla do teclado deixa de ser pressionada.

LostKeyboardFocus

Ocorre quando um elemento perde o foco do teclado.

PreviewGotKeyboardFocus

Ocorre quando um elemento está adquirindo o foco do teclado.

PreviewKeyboardInputProviderAcquireFocus

Ocorre quando o provedor de entrada do teclado está adquirindo o foco.

PreviewKeyDown

Ocorre quando uma tecla do teclado é pressionada.

PreviewKeyUp

Ocorre quando uma tecla do teclado deixa de ser pressionada.

PreviewLostKeyboardFocus

Ocorre quando um elemento está no processo de perder o foco do teclado.

Aplica-se a

Confira também