Keyboard Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o dispositivo de teclado.
public ref class Keyboard abstract sealedpublic static class Keyboardtype Keyboard = classPublic 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
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. |
