Keyboard Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta il dispositivo tastiera.
public ref class Keyboard abstract sealedpublic static class Keyboardtype Keyboard = classPublic Class Keyboard- Ereditarietà
-
Keyboard
Esempio
Nell'esempio seguente viene illustrato come utilizzare il IsKeyToggled metodo per determinare se una chiave si trova nello stato toggled. Se l'oggetto Key passato a IsKeyToggled viene attivato o disattivato, lo sfondo di un pulsante viene modificato.
// 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
Commenti
La Keyboard classe fornisce eventi, metodi e proprietà correlati alla tastiera che forniscono informazioni sullo stato della tastiera.
Ogni evento che Keyboard definisce come evento associato viene esposto nuovamente dalle classi UIElement di elementi di base e ContentElement come nuovo evento indirizzato. In genere, è più pratico gestire gli eventi della tastiera per un'applicazione in UIElement e ContentElement, anziché usare gli Keyboard eventi. Per informazioni dettagliate, vedere Panoramica dell'input.
Affinché un elemento riceva l'input da tastiera, l'elemento deve essere attivabile. La maggior parte degli UIElement oggetti derivati è attivabile per impostazione predefinita. In caso contrario, per rendere attivabile un elemento, impostare la Focusable proprietà sull'elemento di base su true. Per altre informazioni sugli elementi di base, vedere Panoramica degli elementi di base.
Panel le classi, ad esempio StackPanel e Canvas, impostano il valore predefinito di Focusable su false. Pertanto, affinché questi oggetti ottengano lo stato attivo della tastiera, Focusable devono essere impostati su true.
Lo stato attivo della tastiera fa riferimento all'oggetto che riceve l'input da tastiera. L'elemento con lo stato attivo della tastiera è IsKeyboardFocused impostato su true. Può essere presente un solo elemento con lo stato attivo della tastiera sull'intero desktop. Lo stato attivo logico fa riferimento all'oggetto all'interno di un ambito dello stato attivo con stato attivo. Per altre informazioni sullo stato attivo, lo stato attivo della tastiera e lo stato attivo logico, vedere Panoramica dell'input e Panoramica dello stato attivo.
I membri statici della Keyboard classe delegata al thread primario KeyboardDevice del thread chiamante, quindi non sono necessariamente thread-safe.
Campi
| GotKeyboardFocusEvent |
Identifica l'evento associato GotKeyboardFocus. |
| KeyboardInputProviderAcquireFocusEvent |
Identifica l'evento associato KeyboardInputProviderAcquireFocus. |
| KeyDownEvent |
Identifica l'evento associato KeyDown. |
| KeyUpEvent |
Identifica l'evento associato KeyUp. |
| LostKeyboardFocusEvent |
Identifica l'evento associato LostKeyboardFocus. |
| PreviewGotKeyboardFocusEvent |
Identifica l'evento associato PreviewGotKeyboardFocus. |
| PreviewKeyboardInputProviderAcquireFocusEvent |
Identifica l'evento associato PreviewKeyboardInputProviderAcquireFocus. |
| PreviewKeyDownEvent |
Identifica l'evento associato PreviewKeyDown. |
| PreviewKeyUpEvent |
Identifica l'evento associato PreviewKeyUp. |
| PreviewLostKeyboardFocusEvent |
Identifica l'evento associato PreviewLostKeyboardFocus. |
Proprietà
| DefaultRestoreFocusMode |
Ottiene o imposta il comportamento di Windows Presentation Foundation (WPF) durante il ripristino dello stato attivo. |
| FocusedElement |
Ottiene l'elemento con lo stato attivo. |
| Modifiers |
Ottiene l'insieme dell'oggetto ModifierKeys che rappresenta i tasti correntemente premuti. |
| PrimaryDevice |
Ottiene il dispositivo di input della tastiera primario. |
Metodi
Eventi associati
| GotKeyboardFocus |
Richiamato quando un elemento riceve lo stato attivo dalla tastiera. |
| KeyboardInputProviderAcquireFocus |
Si verifica quando il provider di input della tastiera acquisisce lo stato attivo. |
| KeyDown |
Si verifica quando viene premuto un tasto della tastiera. |
| KeyUp |
Si verifica quando viene rilasciato un tasto della tastiera. |
| LostKeyboardFocus |
Si verifica quando un elemento perde lo stato attivo della tastiera. |
| PreviewGotKeyboardFocus |
Si verifica quando un elemento sta per acquisire lo stato attivo della tastiera. |
| PreviewKeyboardInputProviderAcquireFocus |
Si verifica quando il provider di input della tastiera sta per acquisire lo stato attivo. |
| PreviewKeyDown |
Si verifica quando viene premuto un tasto della tastiera. |
| PreviewKeyUp |
Si verifica quando viene rilasciato un tasto della tastiera. |
| PreviewLostKeyboardFocus |
Si verifica quando un elemento sta per perdere lo stato attivo della tastiera. |
