Keyboard Klasse

Referenz

Definition

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt das Tastaturgerät dar.

public ref class Keyboard abstract sealed

public static class Keyboard

type Keyboard = class

Public Class Keyboard

Vererbung: Object
Keyboard

Beispiele

Das folgende Beispiel zeigt, wie Sie mithilfe der IsKeyToggled Methode ermitteln, ob sich ein Schlüssel im Umschaltzustand befindet. Wenn der Key übergebene Vorgang umgeschaltet IsKeyToggled wird, wird der Hintergrund einer Schaltfläche geändert.

// 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

Hinweise

Die Keyboard Klasse stellt tastaturbezogene Ereignisse, Methoden und Eigenschaften bereit, die Informationen zum Status der Tastatur bereitstellen.

Jedes der Ereignisse, die als angefügtes Ereignis definiert werden, Keyboard wird auch von den Basiselementklassen UIElement und ContentElement als neues Routingereignis wieder verfügbar gemacht. Im Allgemeinen ist es einfacher, Tastaturereignisse für eine Anwendung zu UIElement behandeln und ContentElementnicht die Keyboard Ereignisse zu verwenden. Ausführliche Informationen finden Sie unter "Input Overview".

Damit ein Element Tastatureingaben empfängt, muss das Element fokussierbar sein. Die meisten UIElement abgeleiteten Objekte sind standardmäßig fokussierbar. Wenn Sie andernfalls ein Element fokussierbar machen möchten, legen Sie die Focusable Eigenschaft auf das Basiselement fest.true Weitere Informationen zu den Basiselementen finden Sie in der Übersicht über Basiselemente.

Panel Klassen, z. B StackPanel . und Canvas, legen Sie den Standardwert Focusable auf false. Daher muss für diese Objekte, um den Tastaturfokus abzurufen, Focusable auf truefestgelegt werden.

Der Tastaturfokus bezieht sich auf das Objekt, das Tastatureingaben empfängt. Das Element mit Tastaturfokus hat IsKeyboardFocused auf truefestgelegt. Es kann nur ein Element mit Tastaturfokus auf dem gesamten Desktop vorhanden sein. Der logische Fokus bezieht sich auf das Objekt innerhalb eines Fokusbereichs, der den Fokus besitzt. Weitere Informationen zu Fokus, Tastaturfokus und logischem Fokus finden Sie unter "Übersicht über Eingabe" und "Fokus".

Die statischen Member des Keyboard Klassenstellvertretungs an die Primäre KeyboardDevice des aufrufenden Threads, sodass sie nicht unbedingt threadsicher sind.

Felder

GotKeyboardFocusEvent	Bezeichnet das angefügte GotKeyboardFocus-Ereignis.
KeyboardInputProviderAcquireFocusEvent	Bezeichnet das angefügte KeyboardInputProviderAcquireFocus-Ereignis.
KeyDownEvent	Bezeichnet das angefügte KeyDown-Ereignis.
KeyUpEvent	Bezeichnet das angefügte KeyUp-Ereignis.
LostKeyboardFocusEvent	Bezeichnet das angefügte LostKeyboardFocus-Ereignis.
PreviewGotKeyboardFocusEvent	Bezeichnet das angefügte PreviewGotKeyboardFocus-Ereignis.
PreviewKeyboardInputProviderAcquireFocusEvent	Bezeichnet das angefügte PreviewKeyboardInputProviderAcquireFocus-Ereignis.
PreviewKeyDownEvent	Bezeichnet das angefügte PreviewKeyDown-Ereignis.
PreviewKeyUpEvent	Bezeichnet das angefügte PreviewKeyUp-Ereignis.
PreviewLostKeyboardFocusEvent	Bezeichnet das angefügte PreviewLostKeyboardFocus-Ereignis.

Eigenschaften

DefaultRestoreFocusMode	Dient zum Abrufen oder Festlegen des Verhaltens von Windows Presentation Foundation (WPF) beim Wiederherstellen des Fokus.
FocusedElement	Ruft das Element ab, das den Tastaturfokus besitzt.
Modifiers	Ruft den Satz von ModifierKeys ab, die gerade gedrückt werden.
PrimaryDevice	Ruft das primäre Tastatureingabegerät ab.

Methoden

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Fügt einen Handler für das angefügte GotKeyboardFocus-Ereignis hinzu.
AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Fügt einen Handler für das angefügte KeyboardInputProviderAcquireFocus-Ereignis hinzu.
AddKeyDownHandler(DependencyObject, KeyEventHandler)	Fügt einen Handler für das angefügte KeyDown-Ereignis hinzu.
AddKeyUpHandler(DependencyObject, KeyEventHandler)	Fügt einen Handler für das angefügte KeyUp-Ereignis hinzu.
AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Fügt einen Handler für das angefügte LostKeyboardFocus-Ereignis hinzu.
AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Fügt einen Handler für das angefügte PreviewGotKeyboardFocus-Ereignis hinzu.
AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Fügt einen Handler für das angefügte PreviewKeyboardInputProviderAcquireFocus-Ereignis hinzu.
AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Fügt einen Handler für das angefügte PreviewKeyDown-Ereignis hinzu.
AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Fügt einen Handler für das angefügte PreviewKeyUp-Ereignis hinzu.
AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Fügt einen Handler für das angefügte PreviewLostKeyboardFocus-Ereignis hinzu.
ClearFocus()	Löscht den Fokus.
Focus(IInputElement)	Legt den Tastaturfokus für das angegebene Element fest.
GetKeyStates(Key)	Ruft den Satz von Tastaturzuständen für die angegebene Taste ab.
IsKeyDown(Key)	Bestimmt, ob die angegebene Taste gedrückt ist.
IsKeyToggled(Key)	Bestimmt, ob die angegebene Taste umgeschaltet ist.
IsKeyUp(Key)	Bestimmt, ob die angegebene Taste losgelassen wird.
RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Entfernt einen Handler für das angefügte GotKeyboardFocus-Ereignis.
RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Entfernt einen Handler für das angefügte KeyboardInputProviderAcquireFocus-Ereignis.
RemoveKeyDownHandler(DependencyObject, KeyEventHandler)	Entfernt einen Handler für das angefügte KeyDown-Ereignis.
RemoveKeyUpHandler(DependencyObject, KeyEventHandler)	Entfernt einen Handler für das angefügte KeyUp-Ereignis.
RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Entfernt einen Handler für das angefügte LostKeyboardFocus-Ereignis.
RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Entfernt einen Handler für das angefügte PreviewGotKeyboardFocus-Ereignis.
RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Entfernt einen Handler für das angefügte PreviewKeyboardInputProviderAcquireFocus-Ereignis.
RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Entfernt einen Handler für das angefügte PreviewKeyDown-Ereignis.
RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Entfernt einen Handler für das angefügte PreviewKeyUp-Ereignis.
RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Entfernt einen Handler für das angefügte PreviewLostKeyboardFocus-Ereignis.

Angefügte Ereignisse

GotKeyboardFocus	Tritt auf, wenn ein Element den Tastaturfokus erhält.
KeyboardInputProviderAcquireFocus	Tritt auf, wenn der Tastatureingabeanbieter den Fokus erhält.
KeyDown	Tritt ein, wenn eine Taste auf der Tastatur gedrückt wird.
KeyUp	Tritt ein, wenn eine Taste auf der Tastatur losgelassen wird.
LostKeyboardFocus	Tritt auf, wenn ein Element den Tastaturfokus verliert.
PreviewGotKeyboardFocus	Tritt auf, wenn ein Element dabei ist, den Tastaturfokus zu erwerben.
PreviewKeyboardInputProviderAcquireFocus	Tritt auf, wenn der Tastatureingabeanbieter gerade den Fokus erhält.
PreviewKeyDown	Tritt ein, wenn eine Taste auf der Tastatur gedrückt wird.
PreviewKeyUp	Tritt ein, wenn eine Taste auf der Tastatur losgelassen wird.
PreviewLostKeyboardFocus	Tritt auf, wenn ein Element dabei ist, den Tastaturfokus zu verlieren.

Gilt für: