ListView.CacheVirtualItems Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce cuando cambia el contenido del área de presentación de un control ListView en modo virtual y ListView determina que se necesita un nuevo intervalo de elementos.

public:
 event System::Windows::Forms::CacheVirtualItemsEventHandler ^ CacheVirtualItems;

public event System.Windows.Forms.CacheVirtualItemsEventHandler? CacheVirtualItems;

member this.CacheVirtualItems : System.Windows.Forms.CacheVirtualItemsEventHandler 

Public Custom Event CacheVirtualItems As CacheVirtualItemsEventHandler 

Tipo de evento

CacheVirtualItemsEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, el controlador de eventos comprueba para asegurarse de que realmente es necesaria una actualización de caché y, a continuación, vuelve a generar la memoria caché. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la VirtualMode propiedad .

//Manages the cache.  ListView calls this when it might need a 
//cache refresh.
void listView1_CacheVirtualItems(object sender, CacheVirtualItemsEventArgs e)
{
    //We've gotten a request to refresh the cache.
    //First check if it's really neccesary.
    if (myCache != null && e.StartIndex >= firstItem && e.EndIndex <= firstItem + myCache.Length)
    {
        //If the newly requested cache is a subset of the old cache, 
        //no need to rebuild everything, so do nothing.
        return;
    }

    //Now we need to rebuild the cache.
    firstItem = e.StartIndex;
    int length = e.EndIndex - e.StartIndex + 1; //indexes are inclusive
    myCache = new ListViewItem[length];
    
    //Fill the cache with the appropriate ListViewItems.
    int x = 0;
    for (int i = 0; i < length; i++)
    {
        x = (i + firstItem) * (i + firstItem);
        myCache[i] = new ListViewItem(x.ToString());
    }
}

'Manages the cache.  ListView calls this when it might need a 
'cache refresh.
Private Sub listView1_CacheVirtualItems(ByVal sender As Object, ByVal e As CacheVirtualItemsEventArgs) Handles listView1.CacheVirtualItems
    'We've gotten a request to refresh the cache.
    'First check if it's really neccesary.
    If Not (myCache Is Nothing) AndAlso e.StartIndex >= firstItem AndAlso e.EndIndex <= firstItem + myCache.Length Then
        'If the newly requested cache is a subset of the old cache, 
        'no need to rebuild everything, so do nothing.
        Return
    End If

    'Now we need to rebuild the cache.
    firstItem = e.StartIndex
    Dim length As Integer = e.EndIndex - e.StartIndex + 1 'indexes are inclusive
    myCache = New ListViewItem(length) {}

    'Fill the cache with the appropriate ListViewItems.
    Dim x As Integer = 0
    Dim i As Integer
    For i = 0 To length
        x = (i + firstItem) * (i + firstItem)
        myCache(i) = New ListViewItem(x.ToString())
    Next i

End Sub

Comentarios

Este evento solo se produce cuando VirtualMode es true. Controlar este evento permite ListView actualizar la información del elemento contenida en la memoria caché para que esté disponible fácilmente. Esto puede mejorar el rendimiento en listas grandes o listas cuyos elementos son costosos de calcular.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.