ComboBox.BeginUpdate Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ComboBox.cs

Conserve les performances lorsque les éléments sont ajoutés à celui-ci à la ComboBox fois.

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 recommandée pour ajouter des éléments à la ComboBox classe consiste à utiliser la AddRange méthode de la ComboBox.ObjectCollection classe (par le biais de 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 par 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 repeint. 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.