Keyboard Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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. |