RichEditBox.TextChanging Evento

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Si verifica in modo sincrono quando il testo nella casella di modifica inizia a cambiare, ma prima di eseguirne il rendering.

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

Tipo evento

TypedEventHandler<RichEditBox,RichEditBoxTextChangingEventArgs>

Commenti

Per i dati dell'evento, vedere RichEditBoxTextChangingEventArgs.

L'evento TextChanging si verifica in modo sincrono prima del rendering del nuovo testo. Al contrario, l'evento TextChanged è asincrono e si verifica dopo il rendering del nuovo testo.

Quando si verifica l'evento TextChanging, la proprietà Document riflette già il nuovo valore (ma non viene eseguito il rendering nell'interfaccia utente). In genere si gestisce questo evento per aggiornare il valore di testo e la selezione prima del rendering del testo. Ciò impedisce il flickering del testo che può verificarsi quando il testo viene eseguito il rendering, l'aggiornamento e il rendering rapido.

Nota

Si tratta di un evento sincrono che può verificarsi in momenti in cui le modifiche all'albero visivo XAML non sono consentite, ad esempio durante il layout. È pertanto necessario limitare il codice all'interno del gestore eventi TextChanging principalmente per controllare e aggiornare la proprietà Document . Il tentativo di eseguire altre azioni, ad esempio la visualizzazione di un popup o l'aggiunta o la rimozione di elementi dall'albero visivo, potrebbero causare errori potenzialmente irreversibili che possono causare un arresto anomalo. È consigliabile eseguire queste altre modifiche in un gestore eventi TextChanged oppure eseguirle come operazione asincrona separata.

Vedi anche

• RichEditBoxTextChangingEventArgs