Keyboard Klasse

Definition

Stellt das Tastaturgerät dar.Represents the keyboard device.

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 UMSCHALT Zustand befindet.The following example shows how to use the IsKeyToggled method to determine if a key is in the toggled state. Wenn der Key an IsKeyToggled die Übergabe von umgeschaltet wird, wird der Hintergrund einer Schaltfläche geändert.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

Hinweise

Die Keyboard -Klasse stellt Tastatur bezogene Ereignisse, Methoden und Eigenschaften bereit, die Informationen zum Zustand der Tastatur enthalten.The Keyboard class provides keyboard-related events, methods, and properties that provide information regarding the state of the keyboard.

Jedes der Ereignisse, das Keyboard als angefügtes Ereignis definiert, wird auch von den Basiselement Klassen UIElement und ContentElement als neues Routing Ereignis erneut verfügbar gemacht.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. Im Allgemeinen ist es bequemer, Tastatur Ereignisse für eine Anwendung auf UIElement und ContentElementzu verarbeiten, anstatt die Keyboard Ereignisse zu verwenden.Generally, it is more convenient to handle keyboard events for an application on UIElement and ContentElement, rather than using the Keyboard events. Weitere Informationen finden Sie unter Übersicht über die Eingabe.For details, see Input Overview.

Damit ein Element Tastatureingaben empfängt, muss das Element als focbrauchbar sein.In order for an element to receive keyboard input, the element must be focusable. Die UIElement meisten abgeleiteten Objekte können standardmäßig als Fokus verwendet werden.Most UIElement derived objects are focusable by default. Legen Sie andernfalls die Focusable -Eigenschaft für das-Basis trueElement auf fest, damit ein Element Fokus fähig ist.Otherwise, to make an element focusable, set the Focusable property on the base element to true. Weitere Informationen zu den Basiselementen finden Sie unter Übersicht über Basiselemente.For more information on the base elements, see Base Elements Overview.

PanelKlassen, wie z StackPanel . Canvasb. und, legen den Focusable Standard falseWert von auf fest.Panel classes, such as StackPanel and Canvas, set the default value of Focusable to false. Daher Focusable muss für diese Objekte auf truefestgelegt werden, damit Sie den Tastaturfokus erhalten.Therefore, for these objects to obtain keyboard focus, Focusable must be set to true.

Der Tastaturfokus bezieht sich auf das Objekt, das Tastatureingaben empfängt.Keyboard focus refers to the object that is receiving keyboard input. Das Element mit dem Tastaturfokus IsKeyboardFocused ist auf truefestgelegt.The element with keyboard focus has IsKeyboardFocused set to true. Es darf nur ein Element mit dem Tastaturfokus auf dem gesamten Desktop vorhanden sein.There can be only one element with keyboard focus on the entire desktop. Der logische Fokus bezieht sich auf das Objekt innerhalb eines Fokusbereichs, der den Fokus besitzt.Logical focus refers to the object within a focus scope that has focus. Weitere Informationen zu Fokus, Tastaturfokus und logischem Fokus finden Sie unter Übersicht über Eingaben und Fokus.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

Die statischen Member der Keyboard -Klasse delegieren an den primären KeyboardDevice des aufrufenden Threads, sodass Sie nicht notwendigerweise Thread sicher sind.The static members of the Keyboard class delegate to the primary KeyboardDevice of the calling thread, so they are not necessarily thread-safe.

Felder

GotKeyboardFocusEvent

Bezeichnet das angefügte GotKeyboardFocus-Ereignis.Identifies the GotKeyboardFocus attached event.

KeyboardInputProviderAcquireFocusEvent

Bezeichnet das angefügte KeyboardInputProviderAcquireFocus-Ereignis.Identifies the KeyboardInputProviderAcquireFocus attached event.

KeyDownEvent

Bezeichnet das angefügte KeyDown-Ereignis.Identifies the KeyDown attached event.

KeyUpEvent

Bezeichnet das angefügte KeyUp-Ereignis.Identifies the KeyUp attached event.

LostKeyboardFocusEvent

Bezeichnet das angefügte LostKeyboardFocus-Ereignis.Identifies the LostKeyboardFocus attached event.

PreviewGotKeyboardFocusEvent

Bezeichnet das angefügte PreviewGotKeyboardFocus-Ereignis.Identifies the PreviewGotKeyboardFocus attached event.

PreviewKeyboardInputProviderAcquireFocusEvent

Bezeichnet das angefügte PreviewKeyboardInputProviderAcquireFocus-Ereignis.Identifies the PreviewKeyboardInputProviderAcquireFocus attached event.

PreviewKeyDownEvent

Bezeichnet das angefügte PreviewKeyDown-Ereignis.Identifies the PreviewKeyDown attached event.

PreviewKeyUpEvent

Bezeichnet das angefügte PreviewKeyUp-Ereignis.Identifies the PreviewKeyUp attached event.

PreviewLostKeyboardFocusEvent

Bezeichnet das angefügte PreviewLostKeyboardFocus-Ereignis.Identifies the PreviewLostKeyboardFocus attached event.

Eigenschaften

DefaultRestoreFocusMode

Ruft das Verhalten von Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) beim Wiederherstellen des Fokus ab oder legt es fest.Gets or sets the behavior of Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) when restoring focus.

FocusedElement

Ruft das Element ab, das den Tastaturfokus besitzt.Gets the element that has keyboard focus.

Modifiers

Ruft den Satz von ModifierKeys ab, die gerade gedrückt werden.Gets the set of ModifierKeys that are currently pressed.

PrimaryDevice

Ruft das primäre Tastatureingabegerät ab.Gets the primary keyboard input device.

Methoden

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Fügt einen Handler für das angefügte GotKeyboardFocus-Ereignis hinzu.Adds a handler for the GotKeyboardFocus attached event.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Fügt einen Handler für das angefügte KeyboardInputProviderAcquireFocus-Ereignis hinzu.Adds a handler for the KeyboardInputProviderAcquireFocus attached event.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Fügt einen Handler für das angefügte KeyDown-Ereignis hinzu.Adds a handler for the KeyDown attached event.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Fügt einen Handler für das angefügte KeyUp-Ereignis hinzu.Adds a handler for the KeyUp attached event.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Fügt einen Handler für das angefügte LostKeyboardFocus-Ereignis hinzu.Adds a handler for the LostKeyboardFocus attached event.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Fügt einen Handler für das angefügte PreviewGotKeyboardFocus-Ereignis hinzu.Adds a handler for the PreviewGotKeyboardFocus attached event.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Fügt einen Handler für das angefügte PreviewKeyboardInputProviderAcquireFocus-Ereignis hinzu.Adds a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Fügt einen Handler für das angefügte PreviewKeyDown-Ereignis hinzu.Adds a handler for the PreviewKeyDown attached event.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Fügt einen Handler für das angefügte PreviewKeyUp-Ereignis hinzu.Adds a handler for the PreviewKeyUp attached event.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Fügt einen Handler für das angefügte PreviewLostKeyboardFocus-Ereignis hinzu.Adds a handler for the PreviewLostKeyboardFocus attached event.

ClearFocus()

Löscht den Fokus.Clears focus.

Focus(IInputElement)

Legt den Tastaturfokus für das angegebene Element fest.Sets keyboard focus on the specified element.

GetKeyStates(Key)

Ruft den Satz von Tastaturzuständen für die angegebene Taste ab.Gets the set of key states for the specified key.

IsKeyDown(Key)

Bestimmt, ob die angegebene Taste gedrückt ist.Determines whether the specified key is pressed.

IsKeyToggled(Key)

Bestimmt, ob die angegebene Taste umgeschaltet ist.Determines whether the specified key is toggled.

IsKeyUp(Key)

Bestimmt, ob die angegebene Taste losgelassen wird.Determines whether the specified key is released.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Entfernt einen Handler für das angefügte GotKeyboardFocus-Ereignis.Removes a handler for the GotKeyboardFocus attached event.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Entfernt einen Handler für das angefügte KeyboardInputProviderAcquireFocus-Ereignis.Removes a handler for the KeyboardInputProviderAcquireFocus attached event.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Entfernt einen Handler für das angefügte KeyDown-Ereignis.Removes a handler for the KeyDown attached event.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Entfernt einen Handler für das angefügte KeyUp-Ereignis.Removes a handler for the KeyUp attached event.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Entfernt einen Handler für das angefügte LostKeyboardFocus-Ereignis.Removes a handler for the LostKeyboardFocus attached event.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Entfernt einen Handler für das angefügte PreviewGotKeyboardFocus-Ereignis.Removes a handler for the PreviewGotKeyboardFocus attached event.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Entfernt einen Handler für das angefügte PreviewKeyboardInputProviderAcquireFocus-Ereignis.Removes a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Entfernt einen Handler für das angefügte PreviewKeyDown-Ereignis.Removes a handler for the PreviewKeyDown attached event.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Entfernt einen Handler für das angefügte PreviewKeyUp-Ereignis.Removes a handler for the PreviewKeyUp attached event.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Entfernt einen Handler für das angefügte PreviewLostKeyboardFocus-Ereignis.Removes a handler for the PreviewLostKeyboardFocus attached event.

Angefügte Ereignisse

GotKeyboardFocus

Tritt ein, wenn ein Element den Tastaturfokus erhält.Occurs when an element receives keyboard focus.

KeyboardInputProviderAcquireFocus

Tritt auf, wenn der Tastatureingabeanbieter den Fokus erhält.Occurs when the keyboard input provider acquires focus.

KeyDown

Tritt ein, wenn eine Taste auf der Tastatur gedrückt wird.Occurs when a key on the keyboard is pressed.

KeyUp

Tritt ein, wenn eine Taste auf der Tastatur losgelassen wird.Occurs when a key on the keyboard is released.

LostKeyboardFocus

Tritt ein, wenn ein Element den Tastaturfokus verliert.Occurs when an element loses keyboard focus.

PreviewGotKeyboardFocus

Tritt ein, wenn ein Element gerade den Tastaturfokus erhält.Occurs when an element is in the process of acquiring keyboard focus.

PreviewKeyboardInputProviderAcquireFocus

Tritt auf, wenn der Tastatureingabeanbieter gerade den Fokus erhält.Occurs when the keyboard input provider is in the process of acquiring focus.

PreviewKeyDown

Tritt ein, wenn eine Taste auf der Tastatur gedrückt wird.Occurs when a key on the keyboard is pressed.

PreviewKeyUp

Tritt ein, wenn eine Taste auf der Tastatur losgelassen wird.Occurs when a key on the keyboard is released.

PreviewLostKeyboardFocus

Tritt ein, wenn ein Element gerade den Tastaturfokus verliert.Occurs when an element is in the process of losing keyboard focus.

Gilt für:

Siehe auch