RichEditBox.TextChanging Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит синхронно, когда текст в поле ввода начинает изменяться, но до его отрисовки.
// 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"/>
Тип события
Комментарии
Сведения о событиях см. в разделе RichEditBoxTextChangingEventArgs.
Событие TextChanging происходит синхронно перед отображением нового текста. Напротив, событие TextChanged является асинхронным и возникает после отрисовки нового текста.
При возникновении события TextChanging свойство Document уже отражает новое значение (но оно не отображается в пользовательском интерфейсе). Обычно это событие обрабатывается для обновления текстового значения и выделения перед отображением текста. Это предотвращает мерцание текста, которое может произойти при быстрой отрисовки, обновлении и повторной отрисовки текста.
Примечание
Это синхронное событие, которое может возникать в то время, когда изменения визуального дерева XAML недопустимы, например во время макета. Поэтому код в обработчике событий TextChanging следует ограничить главным образом проверкой и обновлением свойства Document . Попытка выполнения других действий, таких как отображение всплывающего окна или добавление или удаление элементов из визуального дерева, может привести к потенциально неустранимые ошибки, которые могут привести к сбою. Мы рекомендуем выполнить эти другие изменения в обработчике событий TextChanged или выполнить их в качестве отдельной асинхронной операции.