Keyboard Classe

Definizione

Rappresenta il dispositivo tastiera.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public 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

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato GotKeyboardFocus.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Aggiunge un gestore per l'evento associato KeyboardInputProviderAcquireFocus.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato KeyDown.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato KeyUp.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato LostKeyboardFocus.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato PreviewGotKeyboardFocus.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Aggiunge un gestore per l'evento associato PreviewKeyboardInputProviderAcquireFocus.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato PreviewKeyDown.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato PreviewKeyUp.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato PreviewLostKeyboardFocus.

ClearFocus()

Cancella lo stato attivo.

Focus(IInputElement)

Imposta lo stato attivo della tastiera sull'elemento specificato.

GetKeyStates(Key)

Ottiene il set di stati per il tasto specificato.

IsKeyDown(Key)

Determina se viene premuto il tasto specificato.

IsKeyToggled(Key)

Determina se il tasto specificato è attivato o disattivato.

IsKeyUp(Key)

Determina se viene rilasciato il tasto specificato.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato GotKeyboardFocus.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Rimuove un gestore per l'evento associato KeyboardInputProviderAcquireFocus.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato KeyDown.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato KeyUp.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato LostKeyboardFocus.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato PreviewGotKeyboardFocus.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Rimuove un gestore per l'evento associato PreviewKeyboardInputProviderAcquireFocus.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato PreviewKeyDown.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato PreviewKeyUp.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato PreviewLostKeyboardFocus.

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.

Si applica a

Vedi anche