RichEditBox.TextChanging Ereignis

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Controls
Bearbeiten

Tritt synchron auf, wenn sich der Text im Bearbeitungsfeld zu ändern beginnt, aber bevor er gerendert wird.

// Register
event_token TextChanging(TypedEventHandler<RichEditBox, RichEditBoxTextChangingEventArgs const&> const& handler) const;

// Revoke with event_token
void TextChanging(event_token const* cookie) const;

// Revoke with event_revoker
RichEditBox::TextChanging_revoker TextChanging(auto_revoke_t, TypedEventHandler<RichEditBox, RichEditBoxTextChangingEventArgs const&> const& handler) const;
public event TypedEventHandler<RichEditBox,RichEditBoxTextChangingEventArgs> TextChanging;
function onTextChanging(eventArgs) { /* Your code */ }
richEditBox.addEventListener("textchanging", onTextChanging);
richEditBox.removeEventListener("textchanging", onTextChanging);
- or -
richEditBox.ontextchanging = onTextChanging;
Public Custom Event TextChanging As TypedEventHandler(Of RichEditBox, RichEditBoxTextChangingEventArgs) 
<RichEditBox TextChanging="eventhandler"/>

Ereignistyp

TypedEventHandler<RichEditBox,RichEditBoxTextChangingEventArgs>

Hinweise

Ereignisdaten finden Sie unter RichEditBoxTextChangingEventArgs.

Das TextChanging-Ereignis tritt synchron auf, bevor der neue Text gerendert wird. Im Gegensatz dazu ist das TextChanged-Ereignis asynchron und tritt auf, nachdem der neue Text gerendert wurde.

Wenn das TextChanging-Ereignis auftritt, spiegelt die Document-Eigenschaft bereits den neuen Wert wider (er wird jedoch nicht auf der Benutzeroberfläche gerendert). In der Regel behandeln Sie dieses Ereignis, um den Textwert und die Auswahl zu aktualisieren, bevor der Text gerendert wird. Dadurch wird das Flackern von Text verhindert, das auftreten kann, wenn Text schnell gerendert, aktualisiert und erneut gerendert wird.

Hinweis

Dies ist ein synchrones Ereignis, das zu Zeiten auftreten kann, wenn Änderungen an der visuellen XAML-Struktur nicht zulässig sind, z. B. während des Layouts. Daher sollten Sie Code innerhalb des TextChanging-Ereignishandlers in erster Linie auf die Überprüfung und Aktualisierung der Document-Eigenschaft beschränken. Der Versuch, andere Aktionen auszuführen, z. B. das Anzeigen eines Popups oder das Hinzufügen/Entfernen von Elementen aus der visuellen Struktur, kann zu potenziell schwerwiegenden Fehlern führen, die zu einem Absturz führen können. Es wird empfohlen, diese anderen Änderungen entweder in einem TextChanged-Ereignishandler oder als separaten asynchronen Vorgang auszuführen.

Gilt für:

Weitere Informationen