Keyboard Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 true
wartość . 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ą Focusablefalse
na . 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
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. |