Поделиться через


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"/>

Тип события

Требования к Windows

Семейство устройств
Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v5.0)

Комментарии

Примечание

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

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

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

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

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

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

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

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