TextBoxBase.EndChange Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Termina il blocco della modifica.
public:
void EndChange();public void EndChange ();member this.EndChange : unit -> unitPublic 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.