TextBoxBase.BeginChange Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Met en route un bloc de modifications.
public:
void BeginChange();public void BeginChange ();member this.BeginChange : unit -> unitPublic 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é.