Keyboard Класс

Определение

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

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
Наследование
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

Происходит, когда элемент теряет фокус ввода с клавиатуры.

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

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