ListBox.BeginUpdate Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListBox.cs

Udržuje výkon, zatímco položky jsou přidány do ListBox jednoho po druhém tím, že brání ovládacímu prvku ve kreslení, dokud EndUpdate() metoda není volána.

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 a EndUpdate metody 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 a Form že tato metoda je 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 přidání více položek do třídy ListBox je použít AddRange metodu ListBox.ObjectCollection třídy (prostřednictvím Items vlastnosti ListBox). Díky tomu můžete do seznamu přidat pole položek v jedné operaci. Pokud však chcete přidat položky po jednom pomocí Add metody ListBox.ObjectCollection třídy, můžete pomocí BeginUpdate této metody zabránit ovládacímu prvku v překreslení ListBox každé položky do seznamu. Jakmile dokončíte úkol přidávání položek do seznamu, zavolejte metodu EndUpdateListBox , která umožní překreslit. Tímto způsobem přidávání položek může zabránit blikajícímu výkresu ListBox při přidávání velkého počtu položek do seznamu.

Viz také

• EndUpdate()