ListBox.BeginUpdate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Mantiene el rendimiento mientras se agregan elementos al control ListBox de uno en uno al impedir que se dibuje el control hasta que se llame al método EndUpdate().
public:
void BeginUpdate();
public void BeginUpdate ();
member this.BeginUpdate : unit -> unit
Public Sub BeginUpdate ()
Ejemplos
En el ejemplo de código siguiente se usan los BeginUpdate métodos y al EndUpdate agregar cinco mil elementos a .ListBox En este ejemplo se requiere que se haya agregado un ListBox control denominado listBox1
a y Form que este método se coloque dentro del formulario y se le llame desde él.
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
Comentarios
La manera preferida de agregar varios elementos a ListBox es usar el AddRange método de la ListBox.ObjectCollection clase (a través de la Items propiedad de ListBox). Esto le permite agregar una matriz de elementos a la lista en una sola operación. Sin embargo, si desea agregar elementos de uno en uno mediante el Add método de la ListBox.ObjectCollection clase , puede usar el BeginUpdate método para evitar que el control vuelva a pintar cada ListBox vez que se agregue un elemento a la lista. Una vez que haya completado la tarea de agregar elementos a la lista, llame al EndUpdate método para habilitar para ListBox volver a pintar. Esta forma de agregar elementos puede impedir el dibujo parpadeado de ListBox cuando se agrega un gran número de elementos a la lista.