ListBox.BeginUpdate Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gestisce le prestazioni mentre gli elementi vengono aggiunti al controllo ListBox uno per volta, impedendo che il controllo li disegni prima della chiamata del metodo EndUpdate().

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Esempio

Nell'esempio di codice seguente vengono usati i metodi e EndUpdate durante l'aggiunta BeginUpdate di cinquemila elementi a un ListBoxoggetto . In questo esempio è necessario che un ListBox controllo, denominato listBox1, sia stato aggiunto a un Form oggetto e che questo metodo venga inserito all'interno del modulo e chiamato da esso.

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

Commenti

Il modo preferito per aggiungere più elementi all'oggetto ListBox consiste nell'usare il AddRange metodo della ListBox.ObjectCollection classe (tramite la Items proprietà di ListBox). Ciò consente di aggiungere una matrice di elementi all'elenco in una singola operazione. Tuttavia, se si desidera aggiungere elementi uno alla volta usando il Add metodo della ListBox.ObjectCollection classe, è possibile usare il BeginUpdate metodo per impedire al controllo di eseguire il repainting ogni ListBox volta che un elemento viene aggiunto all'elenco. Dopo aver completato l'attività di aggiunta di elementi all'elenco, chiamare il metodo per abilitare il EndUpdate ListBox repository. In questo modo l'aggiunta di elementi può impedire il disegno flickered dell'oggetto ListBox quando viene aggiunto un numero elevato di elementi all'elenco.

Vedi anche

• EndUpdate()