ComboBox.BeginUpdate Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gère les performances quand les éléments sont ajoutés au ComboBox un par un.

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Exemples

L’exemple de code suivant montre l’utilisation des méthodes et EndUpdate des BeginUpdate méthodes. L’exemple fait partie d’un exemple de code complet dans la vue d’ensemble de la ComboBox classe.

void addGrandButton_Click( Object^ sender, System::EventArgs^ e )
{
   comboBox1->BeginUpdate();
   for ( int i = 0; i < 1000; i++ )
   {
      comboBox1->Items->Add( "New Item " + i.ToString() );
   }
   comboBox1->EndUpdate();
}

private void addGrandButton_Click(object sender, System.EventArgs e) {
    comboBox1.BeginUpdate();
    for (int i = 0; i < 1000; i++) {
        comboBox1.Items.Add("New Item " + i.ToString());
    }
    comboBox1.EndUpdate();
}

Private Sub addGrandButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    comboBox1.BeginUpdate()
    Dim I As Integer
    For I = 0 To 1000
        comboBox1.Items.Add("New Item " + i.ToString())
    Next
    comboBox1.EndUpdate()
End Sub

Remarques

Cette méthode empêche le contrôle de peindre jusqu’à ce que la EndUpdate méthode soit appelée.

La méthode préférée pour ajouter des éléments à la ComboBox classe consiste à utiliser la AddRange méthode de la ComboBox.ObjectCollection classe (via la Items propriété du ComboBox). Cela vous permet d’ajouter un tableau d’éléments à la liste à la fois. Toutefois, si vous souhaitez ajouter des éléments un à la fois à l’aide de la Add méthode de la ComboBox.ObjectCollection classe, vous pouvez utiliser la BeginUpdate méthode pour empêcher le contrôle de repeindre chaque ComboBox fois qu’un élément est ajouté à la liste. Une fois que vous avez terminé la tâche d’ajouter des éléments à la liste, appelez la EndUpdate méthode pour activer le ComboBox repaint. Cette façon d’ajouter des éléments peut empêcher le scintillement pendant le dessin du ComboBox moment où un grand nombre d’éléments sont ajoutés à la liste.