Partager via


TextBoxBase.BeginChange Méthode

Définition

Met en route un bloc de modifications.

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

Exemples

L’exemple suivant montre comment utiliser les BeginChange méthodes et EndChange les méthodes pour créer un bloc de modification.

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

Remarques

Notes

Lorsque vous appelez, vous devez également appeler BeginChangeEndChange pour terminer le bloc de modification sinon une exception sera levée.

Un bloc de modification regroupe logiquement plusieurs modifications dans une unité d’annulation unique et empêche le contenu texte ou les événements de modification de sélection d’être déclenchés jusqu’après le bloc de modification. De cette façon, vous pouvez apporter plusieurs modifications à l’élément de texte sans danger de modification de l’élément de texte en même temps par un autre écouteur. Un bloc de modification est créé en appelant la DeclareChangeBlock méthode. L’appel de la BeginChange méthode entraîne l’inclusion de toutes les modifications suivantes dans le bloc de modification spécifié jusqu’à ce qu’un appel correspondant à la EndChange méthode soit effectué.

S’applique à

Voir aussi