Keyboard Klasa

Definicja

Reprezentuje urządzenie klawiaturowe.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
Dziedziczenie
Keyboard

Przykłady

W poniższym przykładzie pokazano, jak za pomocą IsKeyToggled metody określić, czy klucz znajduje się w stanie przełączonego. Key Jeśli przekazany element zostanie IsKeyToggled przełączony, tło przycisku zostanie zmienione.

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

Uwagi

Klasa Keyboard udostępnia zdarzenia, metody i właściwości związane z klawiaturą, które zawierają informacje dotyczące stanu klawiatury.

Każde z zdarzeń, które Keyboard definiuje jako dołączone zdarzenie, jest również ponownie uwidocznione przez klasy UIElement elementów podstawowych i ContentElement jako nowe zdarzenie kierowane. Ogólnie rzecz biorąc, bardziej wygodne jest obsługę zdarzeń klawiatury dla aplikacji w systemach UIElement i ContentElement, a nie przy użyciu zdarzeń Keyboard . Aby uzyskać szczegółowe informacje, zobacz Omówienie danych wejściowych.

Aby element odbierał dane wejściowe klawiatury, element musi być fokusem. Większość UIElement obiektów pochodnych jest domyślnie ustawiana fokusem. W przeciwnym razie, aby element był fokusem, ustaw Focusable właściwość na element podstawowy na truewartość . Aby uzyskać więcej informacji na temat elementów podstawowych, zobacz Omówienie elementów podstawowych.

Panel klasy, takie jak StackPanel i Canvas, ustaw wartość domyślną Focusablefalsena . W związku z tym dla tych obiektów w celu uzyskania fokusu Focusable klawiatury należy ustawić wartość true.

Fokus klawiatury odnosi się do obiektu odbierającego dane wejściowe klawiatury. Element z fokusem klawiatury ma IsKeyboardFocused ustawioną wartość true. Na całym pulpicie może być tylko jeden element z fokusem klawiatury. Fokus logiczny odnosi się do obiektu w zakresie fokusu, który ma fokus. Aby uzyskać więcej informacji na temat fokusu, fokusu klawiatury i fokusu logicznego, zobacz Omówienie danych wejściowych i Omówienie koncentracji uwagi.

Statyczne elementy członkowskie delegata Keyboard klasy do podstawowego KeyboardDevice wątku wywołującego, więc niekoniecznie są bezpieczne wątkowo.

Pola

GotKeyboardFocusEvent

Identyfikuje GotKeyboardFocus dołączone zdarzenie.

KeyboardInputProviderAcquireFocusEvent

Identyfikuje KeyboardInputProviderAcquireFocus dołączone zdarzenie.

KeyDownEvent

Identyfikuje KeyDown dołączone zdarzenie.

KeyUpEvent

Identyfikuje KeyUp dołączone zdarzenie.

LostKeyboardFocusEvent

Identyfikuje LostKeyboardFocus dołączone zdarzenie.

PreviewGotKeyboardFocusEvent

Identyfikuje PreviewGotKeyboardFocus dołączone zdarzenie.

PreviewKeyboardInputProviderAcquireFocusEvent

Identyfikuje PreviewKeyboardInputProviderAcquireFocus dołączone zdarzenie.

PreviewKeyDownEvent

Identyfikuje PreviewKeyDown dołączone zdarzenie.

PreviewKeyUpEvent

Identyfikuje PreviewKeyUp dołączone zdarzenie.

PreviewLostKeyboardFocusEvent

Identyfikuje PreviewLostKeyboardFocus dołączone zdarzenie.

Właściwości

DefaultRestoreFocusMode

Pobiera lub ustawia zachowanie Windows Presentation Foundation (WPF) podczas przywracania fokusu.

FocusedElement

Pobiera element z fokusem klawiatury.

Modifiers

Pobiera zestaw aktualnie naciskanych ModifierKeys .

PrimaryDevice

Pobiera podstawowe urządzenie wejściowe klawiatury.

Metody

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Dodaje procedurę obsługi dołączonego GotKeyboardFocus zdarzenia.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Dodaje procedurę obsługi dołączonego KeyboardInputProviderAcquireFocus zdarzenia.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Dodaje procedurę obsługi dołączonego KeyDown zdarzenia.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Dodaje procedurę obsługi dołączonego KeyUp zdarzenia.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Dodaje procedurę obsługi dołączonego LostKeyboardFocus zdarzenia.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Dodaje procedurę obsługi dołączonego PreviewGotKeyboardFocus zdarzenia.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Dodaje procedurę obsługi dołączonego PreviewKeyboardInputProviderAcquireFocus zdarzenia.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Dodaje procedurę obsługi dołączonego PreviewKeyDown zdarzenia.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Dodaje procedurę obsługi dołączonego PreviewKeyUp zdarzenia.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Dodaje procedurę obsługi dołączonego PreviewLostKeyboardFocus zdarzenia.

ClearFocus()

Czyści fokus.

Focus(IInputElement)

Ustawia fokus klawiatury na określonym elemecie.

GetKeyStates(Key)

Pobiera zestaw stanów kluczy dla określonego klucza.

IsKeyDown(Key)

Określa, czy określony klawisz jest naciśnięty.

IsKeyToggled(Key)

Określa, czy określony klucz jest przełączany.

IsKeyUp(Key)

Określa, czy określony klucz jest zwalniany.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Usuwa procedurę obsługi dołączonego GotKeyboardFocus zdarzenia.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Usuwa procedurę obsługi dołączonego KeyboardInputProviderAcquireFocus zdarzenia.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Usuwa procedurę obsługi dołączonego KeyDown zdarzenia.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Usuwa procedurę obsługi dołączonego KeyUp zdarzenia.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Usuwa procedurę obsługi dołączonego LostKeyboardFocus zdarzenia.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Usuwa procedurę obsługi dołączonego PreviewGotKeyboardFocus zdarzenia.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Usuwa procedurę obsługi dołączonego PreviewKeyboardInputProviderAcquireFocus zdarzenia.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Usuwa procedurę obsługi dołączonego PreviewKeyDown zdarzenia.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Usuwa procedurę obsługi dołączonego PreviewKeyUp zdarzenia.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Usuwa procedurę obsługi dołączonego PreviewLostKeyboardFocus zdarzenia.

Zdarzenia dołączone

GotKeyboardFocus

Występuje, gdy element odbiera fokus klawiatury.

KeyboardInputProviderAcquireFocus

Występuje, gdy dostawca danych wejściowych klawiatury uzyskuje fokus.

KeyDown

Występuje po naciśnięciu klawisza na klawiaturze.

KeyUp

Występuje po zwolnieniu klawisza na klawiaturze.

LostKeyboardFocus

Występuje, gdy element traci fokus klawiatury.

PreviewGotKeyboardFocus

Występuje, gdy element jest w trakcie uzyskiwania fokusu klawiatury.

PreviewKeyboardInputProviderAcquireFocus

Występuje, gdy dostawca danych wejściowych klawiatury jest w trakcie uzyskiwania fokusu.

PreviewKeyDown

Występuje po naciśnięciu klawisza na klawiaturze.

PreviewKeyUp

Występuje po zwolnieniu klawisza na klawiaturze.

PreviewLostKeyboardFocus

Występuje, gdy element jest w trakcie utraty fokusu klawiatury.

Dotyczy

Zobacz też