UIElement.CharacterReceived Événement

Définition

Espace de noms:

Microsoft.UI.Xaml

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>

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 « typeahead find or search » (é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 déclenché que lorsque le caractère composé est 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 for Shift
  • KeyDown pour Maj
  • PreviewKeyDown pour W
  • KeyDown pour W
  • CharacterReceived
  • PreviewKeyUp pour W
  • KeyUp pour W
  • PreviewKeyUp for Shift
  • KeyUp pour Maj
• 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

Voir aussi

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled