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

Im folgenden Beispiel wird gezeigt, wie die IsKeyToggled -Methode verwendet wird, um zu bestimmen, ob sich ein Schlüssel im umgeschalteten Zustand befindet. Wenn das Key übergebene an IsKeyToggled umgeschaltet 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 Zustand der Tastatur bereitstellen.

Jedes der Ereignisse, die Keyboard als angefügtes Ereignis definiert, wird auch von den Basiselementklassen UIElement und ContentElement als neues Routingereignis wieder verfügbar gemacht. Im Allgemeinen ist es bequemer, Tastaturereignisse für eine Anwendung auf UIElement und ContentElementzu behandeln, anstatt die Keyboard Ereignisse zu verwenden. Weitere Informationen finden Sie unter Übersicht über Eingaben.

Damit ein Element Tastatureingaben empfängt, muss das Element fokussierbar sein. Die meisten UIElement abgeleiteten Objekte sind standardmäßig fokussierbar. Legen Sie andernfalls die -Eigenschaft für das Focusable Basiselement auf fest, um ein Element fokussierbar zu machen true. Weitere Informationen zu den Basiselementen finden Sie unter Übersicht über Basiselemente.

Panel Klassen wie StackPanel und Canvaslegen den Standardwert von Focusable auf fest false. Damit diese Objekte den Tastaturfokus erhalten, Focusable muss daher auf truefestgelegt werden.

Tastaturfokus bezieht sich auf das Objekt, das Tastatureingaben empfängt. Das Element mit Tastaturfokus ist IsKeyboardFocused auf truefestgelegt. Es kann nur ein Element mit Tastaturfokus auf dem gesamten Desktop vorhanden sein. Logischer Fokus bezieht sich auf das Objekt in einem Fokusbereich, der den Fokus hat. Weitere Informationen zu Fokus, Tastaturfokus und logischem Fokus finden Sie unter Eingabeübersicht und Fokusübersicht.

Die statischen Member des Keyboard Klassendelegats an das primäre KeyboardDevice Element 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	Ruft das Verhalten von Windows Presentation Foundation (WPF) ab, wenn der Fokus wiederhergestellt wird, oder legt es fest.
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:

Freigeben über