Keyboard Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет устройство клавиатуры.
public ref class Keyboard abstract sealedpublic static class Keyboardtype Keyboard = classPublic Class Keyboard- Наследование
-
Keyboard
Примеры
В следующем примере показано, как использовать IsKeyToggled метод для определения того, находится ли ключ в состоянии переключения. Если переданный KeyIsKeyToggled объект переключится, фон кнопки изменяется.
// 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 предоставляет события, методы и свойства, связанные с клавиатурой, которые предоставляют сведения о состоянии клавиатуры.
Каждый из событий, определяющих Keyboard как присоединенное событие, также повторно предоставляется классами UIElement базовых элементов и ContentElement в качестве нового перенаправленного события. Как правило, удобнее обрабатывать события клавиатуры для приложения UIElement и ContentElementвместо использования Keyboard событий. Дополнительные сведения см. в разделе "Общие сведения о входных данных".
Чтобы элемент получил ввод с клавиатуры, элемент должен быть фокусируемым. Большинство UIElement производных объектов по умолчанию можно сосредоточить. В противном случае, чтобы сделать элемент фокусируемым, задайте Focusable для свойства базовый элемент значение true. Дополнительные сведения о базовых элементах см. в разделе "Общие сведения о базовых элементах".
Panel классы, например StackPanel и Canvas, задайте значение Focusablefalseпо умолчанию . Поэтому для получения фокуса Focusable клавиатуры эти объекты должны иметь значение true.
Фокус клавиатуры ссылается на объект, получающий ввод клавиатуры. Элемент с фокусом клавиатуры имеет IsKeyboardFocused значение true. На рабочем столе может быть только один элемент с фокусом клавиатуры. Логический фокус относится к объекту в области фокуса с фокусом. Дополнительные сведения о фокусе, фокусе клавиатуры и логическом фокусе см. в разделе "Обзор ввода " и "Обзор фокуса".
Статические члены Keyboard делегата класса в основной KeyboardDevice поток вызова, поэтому они не обязательно являются потокобезопасными.
Поля
| Имя | Описание |
|---|---|
| GotKeyboardFocusEvent |
Определяет присоединенное GotKeyboardFocus событие. |
| KeyboardInputProviderAcquireFocusEvent |
Определяет присоединенное KeyboardInputProviderAcquireFocus событие. |
| KeyDownEvent |
Определяет присоединенное KeyDown событие. |
| KeyUpEvent |
Определяет присоединенное KeyUp событие. |
| LostKeyboardFocusEvent |
Определяет присоединенное LostKeyboardFocus событие. |
| PreviewGotKeyboardFocusEvent |
Определяет присоединенное PreviewGotKeyboardFocus событие. |
| PreviewKeyboardInputProviderAcquireFocusEvent |
Определяет присоединенное PreviewKeyboardInputProviderAcquireFocus событие. |
| PreviewKeyDownEvent |
Определяет присоединенное PreviewKeyDown событие. |
| PreviewKeyUpEvent |
Определяет присоединенное PreviewKeyUp событие. |
| PreviewLostKeyboardFocusEvent |
Определяет присоединенное PreviewLostKeyboardFocus событие. |
Свойства
| Имя | Описание |
|---|---|
| DefaultRestoreFocusMode |
Возвращает или задает поведение Windows Presentation Foundation (WPF) при восстановлении фокуса. |
| FocusedElement |
Получает элемент с фокусом клавиатуры. |
| Modifiers |
Возвращает набор ModifierKeys , который в данный момент нажимается. |
| PrimaryDevice |
Получает основное устройство ввода клавиатуры. |
Методы
Присоединенные события
| Имя | Описание |
|---|---|
| GotKeyboardFocus |
Происходит, когда элемент получает фокус клавиатуры. |
| KeyboardInputProviderAcquireFocus |
Возникает, когда поставщик ввода клавиатуры получает фокус. |
| KeyDown |
Происходит при нажатии клавиши на клавиатуре. |
| KeyUp |
Происходит при выпуске клавиши на клавиатуре. |
| LostKeyboardFocus |
Происходит, когда элемент теряет фокус клавиатуры. |
| PreviewGotKeyboardFocus |
Происходит, когда элемент находится в процессе получения фокуса клавиатуры. |
| PreviewKeyboardInputProviderAcquireFocus |
Происходит, когда поставщик ввода клавиатуры находится в процессе получения фокуса. |
| PreviewKeyDown |
Происходит при нажатии клавиши на клавиатуре. |
| PreviewKeyUp |
Происходит при выпуске клавиши на клавиатуре. |
| PreviewLostKeyboardFocus |
Происходит, когда элемент находится в процессе потери фокуса клавиатуры. |
