UIElement.CharacterReceived Событие

Определение

Происходит при получении одного составного символа входной очередью.

// Register
event_token CharacterReceived(TypedEventHandler<UIElement, CharacterReceivedRoutedEventArgs const&> const& handler) const;

// Revoke with event_token
void CharacterReceived(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::CharacterReceived_revoker CharacterReceived(auto_revoke_t, TypedEventHandler<UIElement, CharacterReceivedRoutedEventArgs const&> const& handler) const;
public event TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs> CharacterReceived;
function onCharacterReceived(eventArgs) { /* Your code */ }
uIElement.addEventListener("characterreceived", onCharacterReceived);
uIElement.removeEventListener("characterreceived", onCharacterReceived);
- or -
uIElement.oncharacterreceived = onCharacterReceived;
Public Custom Event CharacterReceived As TypedEventHandler(Of UIElement, CharacterReceivedRoutedEventArgs) 
<uiElement CharacterReceived="eventhandler"/>

Тип события

Комментарии

Примечание

Составной символ — это один визуальный объект, производный от последовательности одного или нескольких других символов.

CharacterReceived — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.

Приложения не получают это событие, если включен редактор метода ввода (IME). Редактор метода ввода (IME) обрабатывает все входные данные с клавиатуры и устанавливает значение Handled в значение true.

Это событие полезно для сценариев ввода текста, таких как typeahead find or search (также известный как добавочный поиск, добавочный поиск или предложения в режиме реального времени), где по мере ввода пользователем элемент управления последовательно ищет и фильтрует текст на основе символов в очереди ввода.

Событие CharacterReceived может возникать в разное время в зависимости от введенного символа, так как событие не запускается, пока составной символ не будет зарегистрирован во входной очереди.

  • Пользователь нажимает клавишу W (получается символ w):
    • PreviewKeyDown для W
    • KeyDown для W
    • CharacterReceived
    • PreviewKeyUp для W
    • KeyUp для W
  • Пользователь нажимает клавиши SHIFT+W (получается символ W):
    • PreviewKeyDown для shift
    • KeyDown для shift
    • PreviewKeyDown для W
    • KeyDown для W
    • CharacterReceived
    • PreviewKeyUp для W
    • KeyUp для W
    • PreviewKeyUp for Shift
    • KeyUp для SHIFT
  • Пользователь нажимает клавиши ALT+164 с помощью NumPad (получается символ ñ):
    • PreviewKeyDown для alt
    • KeyDown для alt
    • PreviewKeyDown для 1
    • KeyDown для 1
    • PreviewKeyUp для 1
    • KeyUp для 1
    • PreviewKeyDown для 6
    • KeyDown для 6
    • PreviewKeyUp для 6
    • KeyUp для 6
    • PreviewKeyDown для 4
    • KeyDown для 4
    • PreviewKeyUp для 4
    • KeyUp для 4
    • CharacterReceived
    • PreviewKeyUp для alt
    • Клавиша KeyUp для ALT

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

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