UIElement.KeyUp Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при отпускание клавиши клавиатуры, когда элемент UIElement находится в фокусе.
public:
virtual event KeyEventHandler ^ KeyUp;// Register
event_token KeyUp(KeyEventHandler const& handler) const;
// Revoke with event_token
void KeyUp(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::KeyUp_revoker KeyUp(auto_revoke_t, KeyEventHandler const& handler) const;public event KeyEventHandler KeyUp;function onKeyUp(eventArgs) { /* Your code */ }
uIElement.addEventListener("keyup", onKeyUp);
uIElement.removeEventListener("keyup", onKeyUp);
- or -
uIElement.onkeyup = onKeyUp;Public Custom Event KeyUp As KeyEventHandler <uiElement KeyUp="eventhandler"/>
Тип события
Комментарии
Элементы пользовательского интерфейса создают события клавиатуры только при наличии у них фокуса ввода. По умолчанию первый фокусируемый элемент в визуальном дереве получает фокус системы. Отдельный элемент управления получает фокус, когда пользователь щелкает этот элемент или касается его непосредственно в макете либо переходит на него с помощью клавиши Tab по последовательности табуляции в пределах области размещения содержимого. Вы также можете сосредоточить элементы управления программными средствами, вызвав Control.Focus.
KeyUp — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
KeyUp использует данные события KeyRoutedEventArgs . Наиболее значимыми свойствами KeyRoutedEventArgs в большинстве сценариев использования обработчиков являются Key и, возможно, KeyStatus. Дополнительные сведения об обработке событий клавиатуры, включая пример кода для определения метода KeyEventHandler , см. в разделе Взаимодействие с помощью клавиатуры.
Одним из сценариев обработки событий клавиатуры является поддержка клавиш доступа или сочетаний клавиш для приложения, региона или элемента управления в приложении. Дополнительные сведения об этом сценарии см. в статье Специальные возможности клавиатуры.
Определенные элементы управления среда выполнения Windows могут обрабатываться на основе классов для события ввода KeyUp. В этом случае элемент управления, вероятно, имеет переопределение для метода OnKeyUp. Обычно эти обработчики классов предназначены для обработки подмножества нажатий клавиш, которые позволяют пользователю взаимодействовать с этим элементом управления на основе клавиатуры, и часто это взаимодействие поддерживает специальные возможности клавиатуры. Если событие клавиши клавиатуры обрабатывается с помощью обработки на основе классов, то событие клавиши считается уже обработанным, а событие KeyUp не вызывается для обработки любыми обработчиками пользовательского кода в этом элементе управления. Обычно это всего лишь для нескольких выделенных ключей. Например, ButtonBase имеет обработку классов, чтобы клавиши ПРОБЕЛ и ВВОД обрабатывались как эквиваленты клавиатуры для вызова кнопки. Это встроенный эквивалент клавиатуры для нажатия кнопки или нажатия на нее с помощью мыши, а также позволяет использовать пользовательский интерфейс и кнопку только с помощью клавиатуры. Но любые другие клавиши, кроме ПРОБЕЛ или ВВОД, по-прежнему будут вызывать события KeyDown и KeyUp для кнопки. Дополнительные сведения о том, как работает обработка событий на основе классов, см. в статье Обзор событий и перенаправленных событий.
KeyUp поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.