Sprache

UIElement.CharacterReceived Ereignis

Definition

Namespace:
Microsoft.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>

Hinweise

Hinweis

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

CharacterReceived ist ein Routingereignis. Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".

Apps empfangen dieses Ereignis nicht, wenn ein Eingabemethoden-Editor (INPUT Method Editor, IME) aktiviert ist. Der Eingabemethoden-Editor (INPUT Method Editor, IME) behandelt alle Tastatureingaben und legt "Handled " auf "true" fest.

Dieses Ereignis ist nützlich für Texteingabeszenarien wie "typeahead find or search" (auch als inkrementelle Suche, inkrementelle Suche oder Echtzeitvorschläge bezeichnet), wobei das Steuerelement, während der Benutzer eingibt, nach Text basierend auf den Zeichen in der Eingabewarteschlange schrittweise sucht und filtert.

Das CharacterReceived-Ereignis kann je nach eingegebenen 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-Taste (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