ListBox.BeginUpdate Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Mantém o desempenho enquanto itens são adicionados ao ListBox um de cada vez evitando que o controle desenhe até que o método EndUpdate() seja chamado.

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Exemplos

O exemplo de código a seguir usa os métodos e EndUpdate a BeginUpdate adição de cinco mil itens a um ListBox. Este exemplo exige que um ListBox controle, nomeado listBox1, tenha sido adicionado a um Form e que esse método seja colocado dentro do formulário e chamado dele.

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

Comentários

A maneira preferencial para adicionar vários itens para o ListBox é usar o AddRange método da ListBox.ObjectCollection classe (por meio do Items propriedade do ListBox). Isso permite que você adicione uma matriz de itens à lista em uma única operação. No entanto, se você quiser adicionar itens um de cada vez usando o Add método da ListBox.ObjectCollection classe, poderá usar o BeginUpdate método para impedir que o controle repinte sempre que ListBox um item é adicionado à lista. Depois de concluir a tarefa de adicionar itens à lista, chame o EndUpdate método para habilitar a ListBox repintagem. Essa maneira de adicionar itens pode impedir o ListBox desenho cintilado do quando um grande número de itens estão sendo adicionados à lista.

Confira também

• EndUpdate()