Keyboard Classe

Definição

Representa o dispositivo com teclado.

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

Exemplos

O exemplo seguinte mostra como usar o IsKeyToggled método para determinar se uma tecla está no estado alternado. Se o Key passado para IsKeyToggled for ativado, o fundo de fundo de um botão é alterado.

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

Observações

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

Cada um dos eventos que Keyboard definem como um evento associado é também reexposto pelas classes UIElement de elementos base e ContentElement como um novo evento encaminhado. Geralmente, é mais conveniente gerir eventos de teclado para uma aplicação em UIElement e ContentElement, em vez de usar os Keyboard eventos. Para mais detalhes, consulte Visão Geral de Entrada.

Para que um elemento receba entrada do teclado, o elemento deve ser focalizável. A maioria dos UIElement objetos derivados é focável por defeito. Caso contrário, para tornar um elemento focável, defina a Focusable propriedade do elemento base para true. Para 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 para false. Portanto, para que estes objetos obtenham foco do teclado, Focusable deve ser definido para true.

O foco do teclado refere-se ao objeto que está a receber a entrada do teclado. O elemento com foco do teclado está IsKeyboardFocused definido para true. Só pode haver um elemento com o teclado focado em todo o ambiente de trabalho. Foco lógico refere-se ao objeto dentro de um âmbito de foco que tem foco. Para mais informações sobre foco, foco do teclado e foco lógico, consulte Visão Geral de Entrada e Visão Geral de Foco.

Os membros estáticos da Keyboard classe delegam para o principal KeyboardDevice do thread que chama, pelo que não são necessariamente seguros para threads.

Campos

Name Description
GotKeyboardFocusEvent

Identifica o GotKeyboardFocus evento anexado.

KeyboardInputProviderAcquireFocusEvent

Identifica o KeyboardInputProviderAcquireFocus evento anexado.

KeyDownEvent

Identifica o KeyDown evento anexado.

KeyUpEvent

Identifica o KeyUp evento anexado.

LostKeyboardFocusEvent

Identifica o LostKeyboardFocus evento anexado.

PreviewGotKeyboardFocusEvent

Identifica o PreviewGotKeyboardFocus evento anexado.

PreviewKeyboardInputProviderAcquireFocusEvent

Identifica o PreviewKeyboardInputProviderAcquireFocus evento anexado.

PreviewKeyDownEvent

Identifica o PreviewKeyDown evento anexado.

PreviewKeyUpEvent

Identifica o PreviewKeyUp evento anexado.

PreviewLostKeyboardFocusEvent

Identifica o PreviewLostKeyboardFocus evento anexado.

Propriedades

Name Description
DefaultRestoreFocusMode

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

FocusedElement

Obtém o elemento que tem foco no teclado.

Modifiers

Obtém o conjunto que ModifierKeys está atualmente prensado.

PrimaryDevice

Recebe o dispositivo principal de entrada do teclado.

Métodos

Name Description
AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um handler para o GotKeyboardFocus evento anexado.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Adiciona um handler para o KeyboardInputProviderAcquireFocus evento anexado.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Adiciona um handler para o KeyDown evento anexado.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Adiciona um handler para o KeyUp evento anexado.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um handler para o LostKeyboardFocus evento anexado.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um handler para o PreviewGotKeyboardFocus evento anexado.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Adiciona um handler para o PreviewKeyboardInputProviderAcquireFocus evento anexado.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Adiciona um handler para o PreviewKeyDown evento anexado.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Adiciona um handler para o PreviewKeyUp evento anexado.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Adiciona um handler para o PreviewLostKeyboardFocus evento anexado.

ClearFocus()

Limpa o foco.

Focus(IInputElement)

Define o foco do teclado no elemento especificado.

GetKeyStates(Key)

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

IsKeyDown(Key)

Determina se a tecla especificada é pressionada.

IsKeyToggled(Key)

Determina se a tecla especificada está ativada.

IsKeyUp(Key)

Determina se a chave especificada é libertada.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um handler para o GotKeyboardFocus evento anexo.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Remove um handler para o KeyboardInputProviderAcquireFocus evento anexo.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Remove um handler para o KeyDown evento anexo.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Remove um handler para o KeyUp evento anexo.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um handler para o LostKeyboardFocus evento anexo.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um handler para o PreviewGotKeyboardFocus evento anexo.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Remove um handler para o PreviewKeyboardInputProviderAcquireFocus evento anexo.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Remove um handler para o PreviewKeyDown evento anexo.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Remove um handler para o PreviewKeyUp evento anexo.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Remove um handler para o PreviewLostKeyboardFocus evento anexo.

Eventos Anexados

Name Description
GotKeyboardFocus

Ocorre quando um elemento recebe foco do teclado.

KeyboardInputProviderAcquireFocus

Ocorre quando o fornecedor de entrada do teclado adquire o foco.

KeyDown

Ocorre quando uma tecla do teclado é pressionada.

KeyUp

Ocorre quando uma tecla no teclado é libertada.

LostKeyboardFocus

Ocorre quando um elemento perde o foco do teclado.

PreviewGotKeyboardFocus

Ocorre quando um elemento está a adquirir o foco do teclado.

PreviewKeyboardInputProviderAcquireFocus

Ocorre quando o fornecedor de entrada do teclado está a tentar obter o foco.

PreviewKeyDown

Ocorre quando uma tecla do teclado é pressionada.

PreviewKeyUp

Ocorre quando uma tecla no teclado é libertada.

PreviewLostKeyboardFocus

Ocorre quando um elemento está a perder o foco do teclado.

Aplica-se a

Ver também