UIElement.KeyDown Событие
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.
public:
virtual event KeyEventHandler ^ KeyDown;// Register
event_token KeyDown(KeyEventHandler const& handler) const;
// Revoke with event_token
void KeyDown(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::KeyDown_revoker KeyDown(auto_revoke_t, KeyEventHandler const& handler) const;public event KeyEventHandler KeyDown;function onKeyDown(eventArgs) { /* Your code */ }
uIElement.addEventListener("keydown", onKeyDown);
uIElement.removeEventListener("keydown", onKeyDown);
- or -
uIElement.onkeydown = onKeyDown;Public Custom Event KeyDown As KeyEventHandler <uiElement KeyDown="eventhandler"/>
Элементы пользовательского интерфейса создают события клавиатуры только при наличии у них фокуса ввода. По умолчанию первый фокусируемый элемент в визуальном дереве получает фокус системы. Отдельный элемент управления получает фокус, когда пользователь щелкает или касается непосредственно этого элемента управления в макете или использует клавишу TAB для перехода в последовательность вкладок в области содержимого. Вы также можете сосредоточить элементы управления программным способом, вызвав UIElement.Focus(Microsoft.UI.Xaml.FocusState).
KeyDown — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
KeyDown использует данные события KeyRoutedEventArgs . Наиболее релевантными свойствами KeyRoutedEventArgs для большинства сценариев обработчика являются Key и, возможно, KeyStatus. Дополнительные сведения об обработке событий клавиатуры, включая пример кода для определения метода KeyEventHandler , см. в разделе Взаимодействие с помощью клавиатуры.
Одним из сценариев обработки событий клавиатуры является поддержка клавиш доступа или сочетаний клавиш для приложения, региона или элемента управления в приложении. Дополнительные сведения об этом сценарии см. в статье Специальные возможности клавиатуры.
Определенные элементы управления среда выполнения Windows могут обрабатываться на основе классов для входного события KeyDown. В этом случае элемент управления, вероятно, имеет переопределение для метода OnKeyDown. Обычно эти обработчики классов предназначены для обработки подмножества нажатий клавиш, которые обеспечивают взаимодействие пользователя с этим элементом управления на основе клавиатуры. Часто это взаимодействие поддерживает специальные возможности клавиатуры. Если нажатие клавиши обрабатывается с помощью обработки на основе класса, то нажатие клавиши считается уже обработанным, и событие KeyDown не вызывается для обработки обработчиками пользовательского кода в этом элементе управления специально для этого ключа. Как правило, это всего лишь для нескольких выделенных ключей. Например, ButtonBase имеет обработку классов, чтобы клавиши ПРОБЕЛ и ВВОД обрабатывались как эквиваленты клавиатуры для вызова кнопки. Он предоставляет встроенный эквивалент клавиатуры для нажатия кнопки или нажатия на нее с помощью мыши и позволяет использовать специальные возможности для использования пользовательского интерфейса и кнопки только с помощью клавиатуры. Но любые другие ключи, кроме ПРОБЕЛ или ВВОД , по-прежнему будут вызывать события KeyDown и KeyUp для Button. Дополнительные сведения о том, как работает обработка событий на основе классов, см. в статье Обзор событий и перенаправленных событий.
KeyDown поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.
| Продукт | Версии |
|---|---|
| Windows App SDK | 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |