ListBox.EndUpdate Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Reprend la peinture du contrôle ListBox après qu'elle a été suspendue par la méthode BeginUpdate().

public:
 void EndUpdate();

public void EndUpdate ();

member this.EndUpdate : unit -> unit

Public Sub EndUpdate ()

Exemples

L’exemple de code suivant utilise les méthodes et EndUpdate les BeginUpdate méthodes tout en ajoutant cinq mille éléments à un ListBox. Cet exemple exige qu’un ListBox contrôle nommé listBox1ait été ajouté à un Form contrôle et que cette méthode soit placée dans le formulaire et appelée à partir de celle-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 méthode préférée pour ajouter des éléments à la ListBox classe consiste à utiliser la AddRange méthode de la ListBox.ObjectCollection classe (par le biais de la Items propriété du ListBox). 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 ListBox.ObjectCollection classe, vous pouvez utiliser la BeginUpdate méthode pour empêcher le contrôle de repeindre chaque ListBox 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 activer le ListBox repeint. Cette façon d’ajouter des éléments peut empêcher le dessin scintillement du ListBox moment où un grand nombre d’éléments sont ajoutés à la liste.

Voir aussi

• BeginUpdate()