ListView.CacheVirtualItems Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Se produit lorsque le contenu de la zone d'affichage de ListView en mode virtuel a été modifié, et que ListView détermine qu'une nouvelle plage d'éléments est nécessaire.

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

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 

Type d'événement

CacheVirtualItemsEventHandler

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, le gestionnaire d’événements vérifie qu’une actualisation du cache est vraiment nécessaire, puis régénère le cache. Cet exemple de code fait partie d’un exemple plus grand fourni pour la VirtualMode propriété.

//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

Remarques

Cet événement se produit uniquement lorsqu’il s’agit VirtualMode truede . La gestion de cet événement permet de ListView mettre à jour les informations d’élément conservées dans le cache afin qu’elles soient facilement disponibles. Cela peut améliorer les performances sur les grandes listes ou les listes dont les éléments sont coûteux à calculer.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.