UIElement.CharacterReceived Ereignis

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

Tritt auf, wenn ein einzelnes zusammengesetztes Zeichen von der Eingabewarteschlange empfangen wird.

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

Ereignistyp

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

Windows-Anforderungen

Gerätefamilie
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Hinweise

Hinweis

Ein zusammengesetztes Zeichen ist ein einzelnes visuelles Objekt, das von einer Sequenz eines oder mehrerer anderer Zeichen abgeleitet wird.

CharacterReceived ist ein Routingereignis. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Apps erhalten dieses Ereignis nicht, wenn ein Eingabemethoden-Editor (IME) aktiviert ist. Der Eingabemethoden-Editor (IME) verarbeitet alle Tastatureingaben und legt Handled auf true fest.

Dieses Ereignis ist nützlich für Texteingabeszenarien wie "typeahead find or search" (auch bekannt als inkrementelle Suche, inkrementelle Suche oder Echtzeitvorschläge), bei denen das Steuerelement während der Eingabe des Benutzers schrittweise nach Text sucht und anhand der Zeichen in der Eingabewarteschlange filtert.

Das CharacterReceived-Ereignis kann je nach eingegebenem Zeichen zu unterschiedlichen Zeiten auftreten, da das Ereignis erst ausgelöst wird, wenn das zusammengesetzte Zeichen in der Eingabewarteschlange registriert ist.

  • Der Benutzer drückt die W-Taste (das Zeichen "w" wird empfangen):
    • PreviewKeyDown für W
    • KeyDown für W
    • CharacterReceived
    • PreviewKeyUp für W
    • KeyUp für W
  • Der Benutzer drückt die UMSCHALT+W-Tasten (das Zeichen "W" wird empfangen):
    • PreviewKeyDown für Shift
    • KeyDown für UMSCHALT
    • PreviewKeyDown für W
    • KeyDown für W
    • CharacterReceived
    • PreviewKeyUp für W
    • KeyUp für W
    • PreviewKeyUp für Umschalt
    • KeyUp für Umschalt
  • Der Benutzer drückt alt+164 mit dem NumPad (das Zeichen "ñ" wird empfangen):
    • PreviewKeyDown für Alt
    • KeyDown für Alt
    • PreviewKeyDown für 1
    • KeyDown für 1
    • PreviewKeyUp für 1
    • KeyUp für 1
    • PreviewKeyDown für 6
    • KeyDown für 6
    • PreviewKeyUp für 6
    • KeyUp für 6
    • PreviewKeyDown für 4
    • KeyDown für 4
    • PreviewKeyUp für 4
    • KeyUp für 4
    • CharacterReceived
    • PreviewKeyUp für Alt
    • KeyUp für Alt

Gilt für:

Weitere Informationen