Keyboard Класс

Определение

Представляет устройство-клавиатуру.Represents the keyboard device.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
Наследование
Keyboard

Примеры

В следующем примере показано, как использовать метод IsKeyToggled, чтобы определить, находится ли ключ в переключенном состоянии.The following example shows how to use the IsKeyToggled method to determine if a key is in the toggled state. Если передаваемый в IsKeyToggled Key переключается, изменяется фон кнопки.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

Комментарии

Класс Keyboard предоставляет события, методы и свойства, связанные с клавиатурой, которые предоставляют сведения о состоянии клавиатуры.The Keyboard class provides keyboard-related events, methods, and properties that provide information regarding the state of the keyboard.

Каждое из событий, которые Keyboard определяет как вложенное событие, также передается классами базового элемента UIElement и ContentElement как новое перенаправленное событие.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. Как правило, более удобно управлять событиями клавиатуры для приложения на UIElement и ContentElement, а не использовать события Keyboard.Generally, it is more convenient to handle keyboard events for an application on UIElement and ContentElement, rather than using the Keyboard events. Дополнительные сведения см. в разделе Общие сведения о входных данных.For details, see Input Overview.

Чтобы элемент мог получать ввод с клавиатуры, элемент должен быть в фокусе.In order for an element to receive keyboard input, the element must be focusable. Большинство UIElement производных объектов являются фокусом по умолчанию.Most UIElement derived objects are focusable by default. В противном случае, чтобы сделать элемент сфокусированным, задайте для свойства Focusable базового элемента значение true.Otherwise, to make an element focusable, set the Focusable property on the base element to true. Дополнительные сведения об основных элементах см. в разделе Общие сведения о базовых элементах.For more information on the base elements, see Base Elements Overview.

Panel классы, такие как StackPanel и Canvas, задайте для Focusable значение по умолчанию false.Panel classes, such as StackPanel and Canvas, set the default value of Focusable to false. Таким образом, чтобы эти объекты получали фокус клавиатуры, Focusable необходимо задать значение true.Therefore, for these objects to obtain keyboard focus, Focusable must be set to true.

Фокус клавиатуры относится к объекту, получающему ввод с клавиатуры.Keyboard focus refers to the object that is receiving keyboard input. Элемент с фокусом клавиатуры имеет IsKeyboardFocused установлен в значение true.The element with keyboard focus has IsKeyboardFocused set to true. На всем рабочем столе может быть только один элемент с фокусом клавиатуры.There can be only one element with keyboard focus on the entire desktop. Логический фокус относится к объекту в области фокуса, имеющей фокус.Logical focus refers to the object within a focus scope that has focus. Дополнительные сведения о фокусе, фокусе клавиатуры и логическом фокусе см. в разделе Общие сведения о входе и Общие сведения о фокусе.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

Статические члены класса Keyboard делегата к основному KeyboardDevice вызывающего потока, поэтому они не обязательно являются потокобезопасными.The static members of the Keyboard class delegate to the primary KeyboardDevice of the calling thread, so they are not necessarily thread-safe.

Поля

GotKeyboardFocusEvent

Идентифицирует присоединенное событие GotKeyboardFocus.Identifies the GotKeyboardFocus attached event.

KeyboardInputProviderAcquireFocusEvent

Идентифицирует присоединенное событие KeyboardInputProviderAcquireFocus.Identifies the KeyboardInputProviderAcquireFocus attached event.

KeyDownEvent

Идентифицирует присоединенное событие KeyDown.Identifies the KeyDown attached event.

KeyUpEvent

Идентифицирует присоединенное событие KeyUp.Identifies the KeyUp attached event.

LostKeyboardFocusEvent

Идентифицирует присоединенное событие LostKeyboardFocus.Identifies the LostKeyboardFocus attached event.

PreviewGotKeyboardFocusEvent

Идентифицирует присоединенное событие PreviewGotKeyboardFocus.Identifies the PreviewGotKeyboardFocus attached event.

PreviewKeyboardInputProviderAcquireFocusEvent

Идентифицирует присоединенное событие PreviewKeyboardInputProviderAcquireFocus.Identifies the PreviewKeyboardInputProviderAcquireFocus attached event.

PreviewKeyDownEvent

Идентифицирует присоединенное событие PreviewKeyDown.Identifies the PreviewKeyDown attached event.

PreviewKeyUpEvent

Идентифицирует присоединенное событие PreviewKeyUp.Identifies the PreviewKeyUp attached event.

PreviewLostKeyboardFocusEvent

Идентифицирует присоединенное событие PreviewLostKeyboardFocus.Identifies the PreviewLostKeyboardFocus attached event.

Свойства

DefaultRestoreFocusMode

Получает или задает поведение Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) при возвращении фокуса.Gets or sets the behavior of Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) when restoring focus.

FocusedElement

Получает элемент, имеющий фокус клавиатуры.Gets the element that has keyboard focus.

Modifiers

Получает набор клавиш ModifierKeys, нажатых в данный момент.Gets the set of ModifierKeys that are currently pressed.

PrimaryDevice

Получает первичное клавиатурное устройство ввода.Gets the primary keyboard input device.

Методы

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Добавляет обработчик для вложенного события GotKeyboardFocus.Adds a handler for the GotKeyboardFocus attached event.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Добавляет обработчик для вложенного события KeyboardInputProviderAcquireFocus.Adds a handler for the KeyboardInputProviderAcquireFocus attached event.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

Добавляет обработчик для вложенного события KeyDown.Adds a handler for the KeyDown attached event.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

Добавляет обработчик для вложенного события KeyUp.Adds a handler for the KeyUp attached event.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Добавляет обработчик для вложенного события LostKeyboardFocus.Adds a handler for the LostKeyboardFocus attached event.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Добавляет обработчик для вложенного события PreviewGotKeyboardFocus.Adds a handler for the PreviewGotKeyboardFocus attached event.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Добавляет обработчик для вложенного события PreviewKeyboardInputProviderAcquireFocus.Adds a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Добавляет обработчик для вложенного события PreviewKeyDown.Adds a handler for the PreviewKeyDown attached event.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Добавляет обработчик для вложенного события PreviewKeyUp.Adds a handler for the PreviewKeyUp attached event.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Добавляет обработчик для вложенного события PreviewLostKeyboardFocus.Adds a handler for the PreviewLostKeyboardFocus attached event.

ClearFocus()

Очищает фокус.Clears focus.

Focus(IInputElement)

Устанавливает фокус клавиатуры на указанный элемент.Sets keyboard focus on the specified element.

GetKeyStates(Key)

Получает набор состояний клавиши для заданной клавиши.Gets the set of key states for the specified key.

IsKeyDown(Key)

Определяет, нажата ли указанная клавиша.Determines whether the specified key is pressed.

IsKeyToggled(Key)

Определяет, включена ли указанная клавиша.Determines whether the specified key is toggled.

IsKeyUp(Key)

Определяет, отпущена ли заданная клавиша.Determines whether the specified key is released.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Удаляет обработчик для вложенного события GotKeyboardFocus.Removes a handler for the GotKeyboardFocus attached event.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Удаляет обработчик для вложенного события KeyboardInputProviderAcquireFocus.Removes a handler for the KeyboardInputProviderAcquireFocus attached event.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

Удаляет обработчик для вложенного события KeyDown.Removes a handler for the KeyDown attached event.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

Удаляет обработчик для вложенного события KeyUp.Removes a handler for the KeyUp attached event.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Удаляет обработчик для вложенного события LostKeyboardFocus.Removes a handler for the LostKeyboardFocus attached event.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Удаляет обработчик для вложенного события PreviewGotKeyboardFocus.Removes a handler for the PreviewGotKeyboardFocus attached event.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

Удаляет обработчик для вложенного события PreviewKeyboardInputProviderAcquireFocus.Removes a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

Удаляет обработчик для вложенного события PreviewKeyDown.Removes a handler for the PreviewKeyDown attached event.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

Удаляет обработчик для вложенного события PreviewKeyUp.Removes a handler for the PreviewKeyUp attached event.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

Удаляет обработчик для вложенного события PreviewLostKeyboardFocus.Removes a handler for the PreviewLostKeyboardFocus attached event.

Присоединенные события

GotKeyboardFocus

Происходит, когда элемент получает фокус клавиатуры.Occurs when an element receives keyboard focus.

KeyboardInputProviderAcquireFocus

Происходит, когда поставщик ввода с клавиатуры получает фокус.Occurs when the keyboard input provider acquires focus.

KeyDown

Происходит при нажатии клавиши на клавиатуре.Occurs when a key on the keyboard is pressed.

KeyUp

Происходит при отпускании клавиши на клавиатуре.Occurs when a key on the keyboard is released.

LostKeyboardFocus

Происходит, когда элемент теряет фокус ввода с клавиатуры.Occurs when an element loses keyboard focus.

PreviewGotKeyboardFocus

Происходит, когда элемент находится в процессе получения фокуса клавиатуры.Occurs when an element is in the process of acquiring keyboard focus.

PreviewKeyboardInputProviderAcquireFocus

Происходит, когда поставщик ввода с клавиатуры находится в процессе получения фокуса.Occurs when the keyboard input provider is in the process of acquiring focus.

PreviewKeyDown

Происходит при нажатии клавиши на клавиатуре.Occurs when a key on the keyboard is pressed.

PreviewKeyUp

Происходит при отпускании клавиши на клавиатуре.Occurs when a key on the keyboard is released.

PreviewLostKeyboardFocus

Происходит, когда элемент теряет фокус ввода с клавиатуры.Occurs when an element is in the process of losing keyboard focus.

Применяется к

Дополнительно