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 a passagem Key for IsKeyToggled alternada, 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 lidar com eventos de teclado para um aplicativo ativado UIElement e ContentElement, em vez de usar os Keyboard eventos. Para obter detalhes, consulte Visão geral da entrada.
Para que um elemento receba a entrada do 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.
Panelclasses, como StackPanel e, defina o valor padrão como falseFocusableCanvas. 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. Pode haver apenas 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
| Nome | 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
| Nome | Description |
|---|---|
| DefaultRestoreFocusMode |
Obtém ou define o comportamento do WPF (Windows Presentation Foundation) ao restaurar o foco. |
| FocusedElement |
Obtém o elemento que tem o foco do teclado. |
| Modifiers |
Obtém o conjunto que ModifierKeys está pressionado no momento. |
| PrimaryDevice |
Obtém o dispositivo de entrada de teclado primário. |
Métodos
Eventos Anexados
| Nome | Description |
|---|---|
| GotKeyboardFocus |
Ocorre quando um elemento recebe o foco do teclado. |
| KeyboardInputProviderAcquireFocus |
Ocorre quando o provedor de entrada de teclado adquire foco. |
| KeyDown |
Ocorre quando uma tecla no teclado é pressionada. |
| KeyUp |
Ocorre quando uma tecla no teclado é lançada. |
| LostKeyboardFocus |
Ocorre quando um elemento perde o foco do teclado. |
| PreviewGotKeyboardFocus |
Ocorre quando um elemento está no processo de aquisição do foco do teclado. |
| PreviewKeyboardInputProviderAcquireFocus |
Ocorre quando o provedor de entrada do teclado está em processo de aquisição de foco. |
| PreviewKeyDown |
Ocorre quando uma tecla no teclado é pressionada. |
| PreviewKeyUp |
Ocorre quando uma tecla no teclado é lançada. |
| PreviewLostKeyboardFocus |
Ocorre quando um elemento está no processo de perder o foco do teclado. |
