UIElement.CharacterReceived Событие

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

Возникает, когда один состоящий символ получается входной очередью.

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

Тип события

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

Комментарии

Note

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

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

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

Это событие полезно для сценариев ввода текста, таких как "typeahead find или 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 для shift
    • KeyUp для shift
  • Пользователь нажимает alt+164 с помощью NumPad (получается символ ñ):
    • PreviewKeyDown для ALT
    • KeyDown для alt
    • PreviewKeyDown для 1
    • KeyDown для 1
    • PreviewKeyUp для 1
    • Ключ для 1
    • PreviewKeyDown для 6
    • KeyDown для 6
    • PreviewKeyUp для 6
    • Ключ для 6
    • PreviewKeyDown для 4
    • KeyDown для 4
    • PreviewKeyUp для 4
    • Ключ для 4
    • CharacterReceived
    • PreviewKeyUp для ALT
    • KeyUp для ALT

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

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