TextBoxBase.BeginChange Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia um bloco de alteração.
public:
void BeginChange();public void BeginChange ();member this.BeginChange : unit -> unitPublic Sub BeginChange ()Exemplos
O exemplo a seguir mostra como usar os BeginChange métodos e EndChange criar um bloco de alteração.
TextBox myTextBox = new TextBox();
// Begin the change block. Once BeginChange() is called
// no text content or selection change events will be raised
// until EndChange is called. Also, all edits made within
// a BeginChange/EndChange block are wraped in a single undo block.
myTextBox.BeginChange();
// Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox";
// Make other changes if desired...
// Whenever BeginChange() is called EndChange() must also be
// called to end the change block.
myTextBox.EndChange();
Dim myTextBox As New TextBox()
' Begin the change block. Once BeginChange() is called
' no text content or selection change events will be raised
' until EndChange is called. Also, all edits made within
' a BeginChange/EndChange block are wraped in a single undo block.
myTextBox.BeginChange()
' Put some initial text in the TextBox.
myTextBox.Text = "Initial text in TextBox"
' Make other changes if desired...
' Whenever BeginChange() is called EndChange() must also be
' called to end the change block.
myTextBox.EndChange()
Comentários
Observação
Ao chamar BeginChange, você também deve chamar EndChange para concluir o bloco de alteração, caso contrário, uma exceção será gerada.
Um bloco de alteração agrupa logicamente várias alterações em uma única unidade de desfazer e impede que o conteúdo de texto ou os eventos de alteração de seleção sejam gerados até depois do bloco de alteração. Dessa forma, você pode fazer várias edições no elemento de texto sem o perigo de o elemento de texto ser alterado ao mesmo tempo por outro ouvinte. Um bloco de alteração é criado chamando o DeclareChangeBlock método. Chamar o BeginChange método faz com que todas as alterações subsequentes sejam incluídas no bloco de alterações especificado até que uma chamada correspondente ao EndChange método seja feita.