TextBoxBase.BeginChange Metodo

Definizione

Inizia il blocco della modifica.

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

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 , è necessario chiamare BeginChangeEndChange anche 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 contenuto di testo o selezione fino a dopo il blocco di modifiche. In questo modo è possibile apportare più modifiche all'elemento di testo senza il pericolo che l'elemento di testo venga modificato contemporaneamente da un altro listener. Viene creato un blocco di modifiche chiamando il DeclareChangeBlock metodo . La chiamata al metodo determina l'inserimento BeginChange 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