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 da 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 di attivazione/disattivazione. 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 anche ri-esposto dalle classi UIElement degli 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 Cenni preliminari sugli 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 del delegato di Keyboard classe al primario KeyboardDevice del thread chiamante, quindi non sono necessariamente thread-safe.
Campi
| Nome | Descrizione |
|---|---|
| GotKeyboardFocusEvent |
Identifica l'evento GotKeyboardFocus associato. |
| KeyboardInputProviderAcquireFocusEvent |
Identifica l'evento KeyboardInputProviderAcquireFocus associato. |
| KeyDownEvent |
Identifica l'evento KeyDown associato. |
| KeyUpEvent |
Identifica l'evento KeyUp associato. |
| LostKeyboardFocusEvent |
Identifica l'evento LostKeyboardFocus associato. |
| PreviewGotKeyboardFocusEvent |
Identifica l'evento PreviewGotKeyboardFocus associato. |
| PreviewKeyboardInputProviderAcquireFocusEvent |
Identifica l'evento PreviewKeyboardInputProviderAcquireFocus associato. |
| PreviewKeyDownEvent |
Identifica l'evento PreviewKeyDown associato. |
| PreviewKeyUpEvent |
Identifica l'evento PreviewKeyUp associato. |
| PreviewLostKeyboardFocusEvent |
Identifica l'evento PreviewLostKeyboardFocus associato. |
Proprietà
| Nome | Descrizione |
|---|---|
| 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 della tastiera. |
| Modifiers |
Ottiene il set di ModifierKeys che sono attualmente premuti. |
| PrimaryDevice |
Ottiene il dispositivo di input della tastiera principale. |
Metodi
Eventi associati
| Nome | Descrizione |
|---|---|
| GotKeyboardFocus |
Si verifica quando un elemento riceve lo stato attivo della tastiera. |
| KeyboardInputProviderAcquireFocus |
Si verifica quando il provider di input della tastiera acquisisce lo stato attivo. |
| KeyDown |
Si verifica quando viene premuto un tasto sulla tastiera. |
| KeyUp |
Si verifica quando viene rilasciato un tasto sulla tastiera. |
| LostKeyboardFocus |
Si verifica quando un elemento perde lo stato attivo della tastiera. |
| PreviewGotKeyboardFocus |
Si verifica quando un elemento è in fase di acquisizione dello stato attivo della tastiera. |
| PreviewKeyboardInputProviderAcquireFocus |
Si verifica quando il provider di input della tastiera è in fase di acquisizione dello stato attivo. |
| PreviewKeyDown |
Si verifica quando viene premuto un tasto sulla tastiera. |
| PreviewKeyUp |
Si verifica quando viene rilasciato un tasto sulla tastiera. |
| PreviewLostKeyboardFocus |
Si verifica quando un elemento è in corso di perdita dello stato attivo della tastiera. |
