KeyEventArgs Класс

Определение

Предоставляет данные для перенаправленных событий KeyUp и KeyDown, а также связанных присоединенных событий и событий предварительного просмотра.Provides data for the KeyUp and KeyDown routed events, as well as related attached and Preview events.

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
Наследование

Комментарии

Этот класс данных события используется со следующими вложенными событиями:This event data class is used with the following attached events:

Этот класс данных события также используется со следующими перенаправленными событиями в базовых элементах.This event data class is also used with the following routed events on base elements. Эти перенаправленные события перенаправляют ранее упомянутые вложенные события, чтобы сделать их более доступными для модели WPFWPFобщего элемента в.These routed events forward the previously listed attached events to make them more accessible to the general element model in WPFWPF.

Вложенные события и перенаправляемые события базового элемента совместно используют свои данные событий, а версии с восходящей маршрутизацией и туннелирования перенаправленных событий также используют совместное использование данных о событиях.The attached events and the base element routed events share their event data, and the bubbling and tunneling versions of the routed events also share event data. Это может повлиять на обрабатываемые характеристики события, когда оно перемещается в маршрут события.This can affect the handled characteristics of the event as it travels the event route. Дополнительные сведения см. в разделе Общие сведения о входных данных.For details, see Input Overview.

Ключ может находиться в состоянии "вверх" и "переключено", а также в состоянии "вниз" и "выключено".A key can be in both the up and toggled states or the down and toggled states. По этой причине определение того, является ли ключ настройкой, не так прост, как проверка KeyStates значения как числового значения.For this reason, determining whether a key is up or down is not as simple as checking the KeyStates value as a numeric value. Вместо этого следует проверить значение, рассматривая его как перечисление флагов.Instead, you should check the value by treating it as a flag enumeration. AND Используйте сравнение первого бита.Use an AND comparison of the first bit. Кроме того, можно использовать вспомогательные IsUpсвойства IsDown, и IsToggled , чтобы определить, является ли данный ключ включенным, отключенным или переключенным.Alternatively, use the helper properties IsUp, IsDown, and IsToggled to determine whether a given key is up, down, or toggled.

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

KeyEventArgs(KeyboardDevice, PresentationSource, Int32, Key)

Инициализирует новый экземпляр класса KeyEventArgs.Initializes a new instance of the KeyEventArgs class.

Свойства

DeadCharProcessedKey

Получает клавишу, которая является частью объединения с мертвой клавишей, для создания одного объединенного символа.Gets the key that is part of dead key composition to create a single combined character.

Device

Получает устройство ввода, инициировавшее это событие.Gets the input device that initiated this event.

(Унаследовано от InputEventArgs)
Handled

Получает или задает значение, обозначающее текущее состояние обработки перенаправленного события при перемещении по маршруту.Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.

(Унаследовано от RoutedEventArgs)
ImeProcessedKey

Получает клавишу клавиатуры, на которою ссылается событие, если эта клавиша будет обрабатываться редактор метода ввода (IME)Input Method Editor (IME).Gets the keyboard key referenced by the event, if the key will be processed by an редактор метода ввода (IME)Input Method Editor (IME).

InputSource

Получает источник ввода, предоставившего данный ввод.Gets the input source that provided this input.

IsDown

Получает значение, которое показывает, нажата ли клавиша, на которую ссылается данное событие.Gets a value that indicates whether the key referenced by the event is in the down state.

IsRepeat

Получает значение, которое указывает, нажата ли повторно клавиша клавиатуры, на которую ссылается данное событие.Gets a value that indicates whether the keyboard key referenced by the event is a repeated key.

IsToggled

Получает значение, которое показывает, включена ли клавиша, на которую ссылается данное событие.Gets a value that indicates whether the key referenced by the event is in the toggled state.

IsUp

Получает значение, которое показывает, является ли ненажатой клавиша, на которую ссылается данное событие.Gets a value that indicates whether the key referenced by the event is in the up state.

Key

Получает клавишу клавиатуры, связанную с данным событием.Gets the keyboard key associated with the event.

KeyboardDevice

Получает устройство клавиатуры, связанное с этим событием ввода.Gets the keyboard device associated with the input event.

(Унаследовано от KeyboardEventArgs)
KeyStates

Получает состояние клавиши клавиатуры, связанной с данным событием.Gets the state of the keyboard key associated with this event.

OriginalSource

Возвращает исходный источник отчетов, определяемый чистой проверкой нажатия до какой-либо возможной корректировки Source родительским классом.Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

(Унаследовано от RoutedEventArgs)
RoutedEvent

Возвращает или задает объект RoutedEvent, связанный с этим экземпляром RoutedEventArgs.Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

(Унаследовано от RoutedEventArgs)
Source

Получает или задает ссылку на объект, создавший событие.Gets or sets a reference to the object that raised the event.

(Унаследовано от RoutedEventArgs)
SystemKey

Получает клавишу клавиатуры, на которою ссылается событие, если эта клавиша будет обрабатываться системой.Gets the keyboard key referenced by the event, if the key will be processed by the system.

Timestamp

Получает время, когда произошло данное событие.Gets the time when this event occurred.

(Унаследовано от InputEventArgs)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InvokeEventHandler(Delegate, Object)

Вызывает обработчики событий способом, зависящим от типа, что может повысить эффективность системы событий.Invokes event handlers in a type-specific way, which can increase event system efficiency.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnSetSource(Object)

При переопределении в производном классе предоставляет точку входа обратного вызова для уведомления в случае изменения значения свойства Source в экземпляре.When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.

(Унаследовано от RoutedEventArgs)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

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