RichEditBox.TextChanging Evento

Definição

Namespace:

Windows.UI.Xaml.Controls

Ocorre de forma síncrona quando o texto na caixa de edição começa a ser alterado, mas antes de ser renderizado.

// 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 de evento

TypedEventHandler<RichEditBox,RichEditBoxTextChangingEventArgs>

Comentários

Para obter dados de evento, consulte RichEditBoxTextChangingEventArgs.

O evento TextChanging ocorre de forma síncrona antes que o novo texto seja renderizado. Por outro lado, o evento TextChanged é assíncrono e ocorre depois que o novo texto é renderizado.

Quando o evento TextChanging ocorre, a propriedade Document já reflete o novo valor (mas não é renderizado na interface do usuário). Normalmente, você manipula esse evento para atualizar o valor de texto e a seleção antes que o texto seja renderizado. Isso impede a cintilação de texto que pode acontecer quando o texto é renderizado, atualizado e renderizado novamente rapidamente.

Observação

Esse é um evento síncrono que pode ocorrer em momentos em que as alterações na árvore visual XAML não são permitidas, como durante o layout. Portanto, você deve limitar o código dentro do manipulador de eventos TextChanging principalmente para inspecionar e atualizar a propriedade Document . Tentar executar outras ações, como mostrar um pop-up ou adicionar/remover elementos da árvore visual, pode causar erros potencialmente fatais que podem levar a uma falha. Recomendamos que você execute essas outras alterações em um manipulador de eventos TextChanged ou execute-as como uma operação assíncrona separada.

Confira também

• RichEditBoxTextChangingEventArgs