Keyboard Класс

Определение

Пространство имен:

System.Windows.Input

Сборка:

PresentationCore.dll

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

public ref class Keyboard abstract sealed

public static class Keyboard

type Keyboard = class

Public Class Keyboard

Наследование

Object

Keyboard

Примеры

В следующем примере показано, как использовать IsKeyToggled метод , чтобы определить, находится ли ключ в состоянии переключения. Если параметр , переданный Key в IsKeyToggled , переключается, фон кнопки изменяется.

// 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	Получает первичное клавиатурное устройство ввода.

Методы

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Добавляет обработчик для вложенного события GotKeyboardFocus.
AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Добавляет обработчик для вложенного события KeyboardInputProviderAcquireFocus.
AddKeyDownHandler(DependencyObject, KeyEventHandler)	Добавляет обработчик для вложенного события KeyDown.
AddKeyUpHandler(DependencyObject, KeyEventHandler)	Добавляет обработчик для вложенного события KeyUp.
AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Добавляет обработчик для вложенного события LostKeyboardFocus.
AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Добавляет обработчик для вложенного события PreviewGotKeyboardFocus.
AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Добавляет обработчик для вложенного события PreviewKeyboardInputProviderAcquireFocus.
AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Добавляет обработчик для вложенного события PreviewKeyDown.
AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Добавляет обработчик для вложенного события PreviewKeyUp.
AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Добавляет обработчик для вложенного события PreviewLostKeyboardFocus.
ClearFocus()	Очищает фокус.
Focus(IInputElement)	Устанавливает фокус клавиатуры на указанный элемент.
GetKeyStates(Key)	Получает набор состояний клавиши для заданной клавиши.
IsKeyDown(Key)	Определяет, нажата ли указанная клавиша.
IsKeyToggled(Key)	Определяет, включена ли указанная клавиша.
IsKeyUp(Key)	Определяет, отпущена ли заданная клавиша.
RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Удаляет обработчик для вложенного события GotKeyboardFocus.
RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Удаляет обработчик для вложенного события KeyboardInputProviderAcquireFocus.
RemoveKeyDownHandler(DependencyObject, KeyEventHandler)	Удаляет обработчик для вложенного события KeyDown.
RemoveKeyUpHandler(DependencyObject, KeyEventHandler)	Удаляет обработчик для вложенного события KeyUp.
RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Удаляет обработчик для вложенного события LostKeyboardFocus.
RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Удаляет обработчик для вложенного события PreviewGotKeyboardFocus.
RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	Удаляет обработчик для вложенного события PreviewKeyboardInputProviderAcquireFocus.
RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)	Удаляет обработчик для вложенного события PreviewKeyDown.
RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)	Удаляет обработчик для вложенного события PreviewKeyUp.
RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	Удаляет обработчик для вложенного события PreviewLostKeyboardFocus.

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

GotKeyboardFocus	Происходит, когда элемент получает фокус клавиатуры.
KeyboardInputProviderAcquireFocus	Происходит, когда поставщик ввода с клавиатуры получает фокус.
KeyDown	Происходит при нажатии клавиши на клавиатуре.
KeyUp	Происходит при отпускании клавиши на клавиатуре.
LostKeyboardFocus	Происходит, когда элемент теряет фокус ввода с клавиатуры.
PreviewGotKeyboardFocus	Происходит, когда элемент находится в процессе получения фокуса клавиатуры.
PreviewKeyboardInputProviderAcquireFocus	Происходит, когда поставщик ввода с клавиатуры находится в процессе получения фокуса.
PreviewKeyDown	Происходит при нажатии клавиши на клавиатуре.
PreviewKeyUp	Происходит при отпускании клавиши на клавиатуре.
PreviewLostKeyboardFocus	Происходит, когда элемент теряет фокус ввода с клавиатуры.

См. также раздел

• KeyboardEventArgs
• KeyEventArgs