UIElement.CharacterReceived Événement

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

Se produit lorsqu’un caractère composé unique est reçu par la file d’attente d’entrée.

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

Type d'événement

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

Configuration requise pour Windows

Famille d’appareils
Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Remarques

Notes

Un caractère composé est un objet visuel unique dérivé d’une séquence d’un ou plusieurs autres caractères.

CharacterReceived est un événement routé. Pour plus d’informations sur le concept d’événement routé, consultez Vue d’ensemble des événements et des événements routés.

Les applications ne reçoivent pas cet événement lorsqu’un éditeur de méthode d’entrée (IME) est activé. L’éditeur de méthode d’entrée (IME) gère toutes les entrées du clavier et définit Handled sur true.

Cet événement est utile pour les scénarios d’entrée de texte tels que « recherche ou recherche de typeahead » (également appelé recherche incrémentielle, recherche incrémentielle ou suggestions en temps réel) où, au fur et à mesure que l’utilisateur tape, le contrôle recherche et filtre progressivement le texte en fonction des caractères de la file d’attente d’entrée.

L’événement CharacterReceived peut se produire à différents moments en fonction du caractère entré, car l’événement n’est pas déclenché tant que le caractère composé n’est pas inscrit dans la file d’attente d’entrée.

  • L’utilisateur appuie sur la touche W (le caractère « w » est reçu) :
    • PreviewKeyDown pour W
    • KeyDown pour W
    • CharacterReceived
    • PreviewKeyUp pour W
    • KeyUp pour W
  • L’utilisateur appuie sur les touches Maj+W (le caractère « W » est reçu) :
    • PreviewKeyDown pour Shift
    • KeyDown pour Shift
    • PreviewKeyDown pour W
    • KeyDown pour W
    • CharacterReceived
    • PreviewKeyUp pour W
    • KeyUp pour W
    • PreviewKeyUp pour Shift
    • KeyUp pour Shift
  • L’utilisateur appuie sur Alt+164 à l’aide du NumPad (le caractère « ñ » est reçu) :
    • PreviewKeyDown pour Alt
    • KeyDown pour Alt
    • PreviewKeyDown pour 1
    • KeyDown pour 1
    • PreviewKeyUp pour 1
    • KeyUp pour 1
    • PreviewKeyDown pour 6
    • KeyDown pour 6
    • PreviewKeyUp pour 6
    • KeyUp pour 6
    • PreviewKeyDown pour 4
    • KeyDown pour 4
    • PreviewKeyUp pour 4
    • KeyUp pour 4
    • CharacterReceived
    • PreviewKeyUp pour Alt
    • KeyUp pour Alt

S’applique à

Voir aussi