ListBox.BeginUpdate Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Maintient les performances quand des éléments sont ajoutés à ListBox un par un en empêchant le contrôle de dessiner tant que la méthode EndUpdate() n'est pas appelée.

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Exemples

L’exemple de code suivant utilise les méthodes et EndUpdate lors de l’ajout BeginUpdate de cinq mille éléments à un ListBox. Cet exemple nécessite qu’un ListBox contrôle, nommé listBox1, ait été ajouté à un Form et que cette méthode soit placée dans le formulaire et appelée à partir de celui-ci.

void AddToMyListBox()
{
   // Stop the ListBox from drawing while items are added.
   listBox1->BeginUpdate();

   // Loop through and add five thousand new items.
   for ( int x = 1; x < 5000; x++ )
   {
      listBox1->Items->Add( String::Format( "Item {0}", x ) );
   }
   listBox1->EndUpdate();
}

public void AddToMyListBox()
{
   // Stop the ListBox from drawing while items are added.
   listBox1.BeginUpdate();

   // Loop through and add five thousand new items.
   for(int x = 1; x < 5000; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());   
   }
   // End the update process and force a repaint of the ListBox.
   listBox1.EndUpdate();
}

Public Sub AddToMyListBox()
    ' Stop the ListBox from drawing while items are added.
    listBox1.BeginUpdate()
       
    ' Loop through and add five thousand new items.
    Dim x As Integer
    For x = 1 To 4999
        listBox1.Items.Add("Item " & x.ToString())
    Next x
    ' End the update process and force a repaint of the ListBox.
    listBox1.EndUpdate()
End Sub

Remarques

La meilleure façon d’ajouter plusieurs éléments à la ListBox consiste à utiliser la AddRange méthode de la ListBox.ObjectCollection classe (via la Items propriété du ListBox). Cela vous permet d’ajouter un tableau d’éléments à la liste en une seule opération. Toutefois, si vous souhaitez ajouter des éléments un par un à l’aide de la Add méthode de la ListBox.ObjectCollection classe , vous pouvez utiliser la BeginUpdate méthode pour empêcher le contrôle de repeindre le ListBox chaque fois qu’un élément est ajouté à la liste. Une fois que vous avez terminé la tâche d’ajout d’éléments à la liste, appelez la EndUpdate méthode pour permettre au ListBox repeint. Cette façon d’ajouter des éléments peut empêcher le ListBox scintillement du lorsque de nombreux éléments sont ajoutés à la liste.

Voir aussi

• EndUpdate()