Keyboard Classe

Definizione

Rappresenta il dispositivo tastiera.Represents the keyboard device.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
Ereditarietà
Keyboard

Esempi

Nell'esempio seguente viene illustrato come utilizzare il IsKeyToggled metodo per determinare se una chiave è nello stato attivato o disattivato.The following example shows how to use the IsKeyToggled method to determine if a key is in the toggled state. Se l' Key oggetto passato IsKeyToggled a viene attivato o disattivato, viene modificato lo sfondo di un pulsante.If the Key passed to IsKeyToggled is toggled, the background of a button is changed.

// 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 relative allo stato della tastiera.The Keyboard class provides keyboard-related events, methods, and properties that provide information regarding the state of the keyboard.

Ogni evento che Keyboard definisce come un evento associato viene anche nuovamente esposto dalle classi UIElement degli elementi di base e ContentElement come nuovo evento indirizzato.Each of the events that Keyboard defines as an attached event is also re-exposed by the base element classes UIElement and ContentElement as a new routed event. In genere, è più semplice gestire gli eventi di tastiera per un'applicazione UIElement in ContentElemente, anziché usare gli Keyboard eventi.Generally, it is more convenient to handle keyboard events for an application on UIElement and ContentElement, rather than using the Keyboard events. Per informazioni dettagliate, vedere Cenni preliminari sull'input.For details, see Input Overview.

Per consentire a un elemento di ricevere l'input da tastiera, l'elemento deve essere attivabile.In order for an element to receive keyboard input, the element must be focusable. Per UIElement impostazione predefinita, la maggior parte degli oggetti derivati è attivabile.Most UIElement derived objects are focusable by default. In caso contrario, per rendere un elemento attivabile, Focusable impostare la proprietà dell'elemento di truebase su.Otherwise, to make an element focusable, set the Focusable property on the base element to true. Per altre informazioni sugli elementi di base, vedere Cenni preliminari sugli elementi di base.For more information on the base elements, see Base Elements Overview.

Panelle classi, ad StackPanel esempio Canvase, impostano il Focusable valore falsepredefinito di su.Panel classes, such as StackPanel and Canvas, set the default value of Focusable to false. Pertanto, affinché questi oggetti ottengano lo stato attivo Focusable , deve essere impostato truesu.Therefore, for these objects to obtain keyboard focus, Focusable must be set to true.

Lo stato attivo della tastiera fa riferimento all'oggetto che riceve l'input da tastiera.Keyboard focus refers to the object that is receiving keyboard input. L'elemento con lo stato attivo IsKeyboardFocused della tastiera trueè impostato su.The element with keyboard focus has IsKeyboardFocused set to true. Può essere presente un solo elemento con lo stato attivo della tastiera sull'intero desktop.There can be only one element with keyboard focus on the entire desktop. Lo stato attivo logico fa riferimento all'oggetto all'interno di un ambito di stato attivo con lo stato attivo.Logical focus refers to the object within a focus scope that has focus. Per altre informazioni sullo stato attivo, lo stato attivo della tastiera e lo stato attivo logico, vedere Cenni preliminari sull' input e Panoramica dello stato attivo.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

I membri statici della Keyboard classe delegano al database primario KeyboardDevice del thread chiamante, quindi non sono necessariamente thread-safe.The static members of the Keyboard class delegate to the primary KeyboardDevice of the calling thread, so they are not necessarily thread-safe.

Campi

GotKeyboardFocusEvent

Identifica l'evento associato GotKeyboardFocus.Identifies the GotKeyboardFocus attached event.

KeyboardInputProviderAcquireFocusEvent

Identifica l'evento associato KeyboardInputProviderAcquireFocus.Identifies the KeyboardInputProviderAcquireFocus attached event.

KeyDownEvent

Identifica l'evento associato KeyDown.Identifies the KeyDown attached event.

KeyUpEvent

Identifica l'evento associato KeyUp.Identifies the KeyUp attached event.

LostKeyboardFocusEvent

Identifica l'evento associato LostKeyboardFocus.Identifies the LostKeyboardFocus attached event.

PreviewGotKeyboardFocusEvent

Identifica l'evento associato PreviewGotKeyboardFocus.Identifies the PreviewGotKeyboardFocus attached event.

PreviewKeyboardInputProviderAcquireFocusEvent

Identifica l'evento associato PreviewKeyboardInputProviderAcquireFocus.Identifies the PreviewKeyboardInputProviderAcquireFocus attached event.

PreviewKeyDownEvent

Identifica l'evento associato PreviewKeyDown.Identifies the PreviewKeyDown attached event.

PreviewKeyUpEvent

Identifica l'evento associato PreviewKeyUp.Identifies the PreviewKeyUp attached event.

PreviewLostKeyboardFocusEvent

Identifica l'evento associato PreviewLostKeyboardFocus.Identifies the PreviewLostKeyboardFocus attached event.

Proprietà

DefaultRestoreFocusMode

Ottiene o imposta il comportamento di Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) quando viene ripristinato lo stato attivo.Gets or sets the behavior of Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) when restoring focus.

FocusedElement

Ottiene l'elemento con lo stato attivo.Gets the element that has keyboard focus.

Modifiers

Ottiene l'insieme dell'oggetto ModifierKeys che rappresenta i tasti correntemente premuti.Gets the set of ModifierKeys that are currently pressed.

PrimaryDevice

Ottiene il dispositivo di input della tastiera primario.Gets the primary keyboard input device.

Metodi

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato GotKeyboardFocus.Adds a handler for the GotKeyboardFocus attached event.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Aggiunge un gestore per l'evento associato KeyboardInputProviderAcquireFocus.Adds a handler for the KeyboardInputProviderAcquireFocus attached event.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato KeyDown.Adds a handler for the KeyDown attached event.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato KeyUp.Adds a handler for the KeyUp attached event.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato LostKeyboardFocus.Adds a handler for the LostKeyboardFocus attached event.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato PreviewGotKeyboardFocus.Adds a handler for the PreviewGotKeyboardFocus attached event.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Aggiunge un gestore per l'evento associato PreviewKeyboardInputProviderAcquireFocus.Adds a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato PreviewKeyDown.Adds a handler for the PreviewKeyDown attached event.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Aggiunge un gestore per l'evento associato PreviewKeyUp.Adds a handler for the PreviewKeyUp attached event.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Aggiunge un gestore per l'evento associato PreviewLostKeyboardFocus.Adds a handler for the PreviewLostKeyboardFocus attached event.

ClearFocus()

Cancella lo stato attivo.Clears focus.

Focus(IInputElement)

Imposta lo stato attivo della tastiera sull'elemento specificato.Sets keyboard focus on the specified element.

GetKeyStates(Key)

Ottiene il set di stati per il tasto specificato.Gets the set of key states for the specified key.

IsKeyDown(Key)

Determina se viene premuto il tasto specificato.Determines whether the specified key is pressed.

IsKeyToggled(Key)

Determina se il tasto specificato è attivato o disattivato.Determines whether the specified key is toggled.

IsKeyUp(Key)

Determina se viene rilasciato il tasto specificato.Determines whether the specified key is released.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato GotKeyboardFocus.Removes a handler for the GotKeyboardFocus attached event.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Rimuove un gestore per l'evento associato KeyboardInputProviderAcquireFocus.Removes a handler for the KeyboardInputProviderAcquireFocus attached event.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato KeyDown.Removes a handler for the KeyDown attached event.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato KeyUp.Removes a handler for the KeyUp attached event.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato LostKeyboardFocus.Removes a handler for the LostKeyboardFocus attached event.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato PreviewGotKeyboardFocus.Removes a handler for the PreviewGotKeyboardFocus attached event.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Rimuove un gestore per l'evento associato PreviewKeyboardInputProviderAcquireFocus.Removes a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato PreviewKeyDown.Removes a handler for the PreviewKeyDown attached event.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Rimuove un gestore per l'evento associato PreviewKeyUp.Removes a handler for the PreviewKeyUp attached event.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Rimuove un gestore per l'evento associato PreviewLostKeyboardFocus.Removes a handler for the PreviewLostKeyboardFocus attached event.

Eventi associati

GotKeyboardFocus

Si verifica quando un elemento riceve lo stato attivo dalla tastiera.Occurs when an element receives keyboard focus.

KeyboardInputProviderAcquireFocus

Si verifica quando il provider di input della tastiera acquisisce lo stato attivo.Occurs when the keyboard input provider acquires focus.

KeyDown

Si verifica quando viene premuto un tasto della tastiera.Occurs when a key on the keyboard is pressed.

KeyUp

Si verifica quando viene rilasciato un tasto della tastiera.Occurs when a key on the keyboard is released.

LostKeyboardFocus

Si verifica quando un elemento perde lo stato attivo della tastiera.Occurs when an element loses keyboard focus.

PreviewGotKeyboardFocus

Si verifica quando un elemento sta per acquisire lo stato attivo della tastiera.Occurs when an element is in the process of acquiring keyboard focus.

PreviewKeyboardInputProviderAcquireFocus

Si verifica quando il provider di input della tastiera sta per acquisire lo stato attivo.Occurs when the keyboard input provider is in the process of acquiring focus.

PreviewKeyDown

Si verifica quando viene premuto un tasto della tastiera.Occurs when a key on the keyboard is pressed.

PreviewKeyUp

Si verifica quando viene rilasciato un tasto della tastiera.Occurs when a key on the keyboard is released.

PreviewLostKeyboardFocus

Si verifica quando un elemento sta per perdere lo stato attivo della tastiera.Occurs when an element is in the process of losing keyboard focus.

Si applica a

Vedi anche