ListBox.BeginUpdate Método

public:
 void BeginUpdate();

public void BeginUpdate();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Exemplos

O seguinte exemplo de código utiliza os BeginUpdate métodos e EndUpdate enquanto adiciona cinco mil itens a um ListBox. Este exemplo exige que um ListBox controlo, chamado listBox1, tenha sido adicionado a Form a e que este método seja colocado dentro da forma e chamado a partir dela.

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

Observações

A forma preferida de adicionar múltiplos itens ao ListBox é usar o AddRange método da ListBox.ObjectCollection classe (através da Items propriedade do ListBox). Isto permite-lhe adicionar um conjunto de itens à lista numa única operação. No entanto, se quiseres adicionar itens um de cada vez usando o Add método da ListBox.ObjectCollection classe, podes usar o BeginUpdate método para evitar que o controlo volte a pintar cada ListBox vez que um item é adicionado à lista. Depois de concluir a tarefa de adicionar itens à lista, ligue ao EndUpdate método para permitir a ListBox repintura. Esta forma de adicionar itens pode evitar o desenho ListBox intermitente quando um grande número de itens está a ser adicionado à lista.

Ver também

• EndUpdate()