Freigeben über


Keyboard Klasse

Definition

Stellt das Tastaturgerät dar.

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

Weitere Informationen