KeyEventArgs Класс

Определение

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

System.Windows.Input

Сборка:

PresentationCore.dll

Предоставляет данные для перенаправленных событий KeyUp и KeyDown, а также связанных присоединенных событий и событий предварительного просмотра.

public ref class KeyEventArgs : System::Windows::Input::KeyboardEventArgs

public class KeyEventArgs : System.Windows.Input.KeyboardEventArgs

type KeyEventArgs = class
    inherit KeyboardEventArgs

Public Class KeyEventArgs
Inherits KeyboardEventArgs

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

Object

EventArgs

RoutedEventArgs

InputEventArgs

KeyboardEventArgs

KeyEventArgs

Комментарии

Этот класс данных события используется со следующими присоединенными событиями:

• Keyboard.KeyUp

• Keyboard.KeyDown

• Keyboard.PreviewKeyUp

• Keyboard.PreviewKeyDown

Этот класс данных событий также используется со следующими перенаправленными событиями в базовых элементах. Эти перенаправленные события перенаправляют ранее перечисленные присоединенные события, чтобы сделать их более доступными для общей модели элементов в WPF.

• UIElement.KeyUp

• UIElement.KeyDown

• UIElement.PreviewKeyUp

• UIElement.PreviewKeyDown

• ContentElement.KeyUp

• ContentElement.KeyDown

• ContentElement.PreviewKeyUp

• ContentElement.PreviewKeyDown

Присоединенные события и перенаправленные события базового элемента совместно используют свои данные о событиях, а версии перенаправленных событий с восходящей и туннелированием также совместно используют данные о событиях. Это может повлиять на обрабатываемые характеристики события по мере его перемещения по маршруту события. Дополнительные сведения см. в разделе Общие сведения о входных данных.

Ключ может находиться как в состоянии "вверх" и "переключение", так и в состоянии "вниз" и "переключение". По этой причине определить, является ли ключ вверх или вниз, не так просто, как проверить KeyStates значение в виде числового значения. Вместо этого следует проверка значение, рассматривая его как перечисление флагов. AND Используйте сравнение первого бита. Кроме того, используйте вспомогательные свойства IsUp, IsDownи IsToggled , чтобы определить, является ли данный ключ вверх, вниз или переключен.

Конструкторы

KeyEventArgs(KeyboardDevice, PresentationSource, Int32, Key)

Инициализирует новый экземпляр класса KeyEventArgs.

Свойства

DeadCharProcessedKey	Получает клавишу, которая является частью объединения с мертвой клавишей, для создания одного объединенного символа.
Device	Получает устройство ввода, инициировавшее это событие. (Унаследовано от InputEventArgs)
Handled	Получает или задает значение, обозначающее текущее состояние обработки перенаправленного события при перемещении по маршруту. (Унаследовано от RoutedEventArgs)
ImeProcessedKey	Возвращает клавишу клавиатуры, на которую ссылается событие , если клавиша будет обработана редактором метода ввода (IME).
InputSource	Получает источник ввода, предоставившего данный ввод.
IsDown	Получает значение, которое показывает, нажата ли клавиша, на которую ссылается данное событие.
IsRepeat	Получает значение, которое указывает, нажата ли повторно клавиша клавиатуры, на которую ссылается данное событие.
IsToggled	Получает значение, которое показывает, включена ли клавиша, на которую ссылается данное событие.
IsUp	Получает значение, которое показывает, является ли ненажатой клавиша, на которую ссылается данное событие.
Key	Получает клавишу клавиатуры, связанную с данным событием.
KeyboardDevice	Получает устройство клавиатуры, связанное с этим событием ввода. (Унаследовано от KeyboardEventArgs)
KeyStates	Получает состояние клавиши клавиатуры, связанной с данным событием.
OriginalSource	Возвращает исходный источник отчетов, определяемый чистой проверкой нажатия до какой-либо возможной корректировки Source родительским классом. (Унаследовано от RoutedEventArgs)
RoutedEvent	Возвращает или задает объект RoutedEvent, связанный с этим экземпляром RoutedEventArgs. (Унаследовано от RoutedEventArgs)
Source	Получает или задает ссылку на объект, создавший событие. (Унаследовано от RoutedEventArgs)
SystemKey	Получает клавишу клавиатуры, на которою ссылается событие, если эта клавиша будет обрабатываться системой.
Timestamp	Получает время, когда произошло данное событие. (Унаследовано от InputEventArgs)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InvokeEventHandler(Delegate, Object)	Вызывает обработчики событий способом, зависящим от типа, что может повысить эффективность системы событий.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnSetSource(Object)	При переопределении в производном классе предоставляет точку входа обратного вызова для уведомления в случае изменения значения свойства Source в экземпляре. (Унаследовано от RoutedEventArgs)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• KeyEventHandler
• KeyboardEventArgs
• KeyboardEventHandler