Condividi tramite


TextBoxBase.EndChange Metodo

Definizione

Termina il blocco della modifica.

public:
 void EndChange();
public void EndChange ();
member this.EndChange : unit -> unit
Public Sub EndChange ()

Esempio

Nell'esempio seguente viene illustrato come usare i BeginChange metodi e EndChange per creare un blocco di modifiche.

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()

Commenti

Nota

Quando si chiama BeginChange, è necessario chiamare anche EndChange per completare il blocco di modifiche in caso contrario verrà generata un'eccezione.

Un blocco di modifiche raggruppa logicamente più modifiche in una singola unità di annullamento e impedisce la generazione di eventi di modifica del testo o selezione fino a quando il blocco di modifiche non viene generato. In questo modo è possibile apportare più modifiche all'elemento di testo senza il pericolo di modifica dell'elemento di testo contemporaneamente da un altro processo. Viene creato un blocco di modifiche chiamando il DeclareChangeBlock metodo . La chiamata al BeginChange metodo causa l'inserimento di tutte le modifiche successive nel blocco di modifiche specificato fino a quando non viene effettuata una chiamata corrispondente al EndChange metodo.

Si applica a

Vedi anche