ListBox.BeginUpdate Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Udržuje výkon při přidávání položek do ListBox jedné po druhé tím, že brání ovládacímu prvku v kreslení, dokud EndUpdate() není volána metoda.

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Příklady

Následující příklad kódu používá BeginUpdate metody a EndUpdate při přidávání pěti tisíc položek do ListBox. Tento příklad vyžaduje, aby ListBox ovládací prvek s názvem listBox1, byl přidán do objektu Form a aby tato metoda byla umístěna ve formuláři a volána z něj.

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

Poznámky

Upřednostňovaným způsobem, jak přidat více položek do ListBox třídy, je použít metodu AddRange ListBox.ObjectCollection třídy (prostřednictvím Items vlastnosti ListBox). To umožňuje přidat pole položek do seznamu v jedné operaci. Pokud však chcete přidávat položky po jednom pomocí Add metody ListBox.ObjectCollection třídy, můžete pomocí BeginUpdate metody zabránit ovládacímu prvku v překreslení ListBox při každém přidání položky do seznamu. Jakmile dokončíte úlohu přidávání položek do seznamu, zavolejte metodu EndUpdate , která povolí ListBox překreslení. Tento způsob přidávání položek může zabránit blikání výkresu ListBox při přidávání velkého počtu položek do seznamu.

Platí pro

Viz také

EndUpdate()

Sdílet prostřednictvím