ListView.RetrieveVirtualItem Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica se la classe ListView è in modalità virtuale e richiede una classe ListViewItem.

public:
 event System::Windows::Forms::RetrieveVirtualItemEventHandler ^ RetrieveVirtualItem;

public event System.Windows.Forms.RetrieveVirtualItemEventHandler? RetrieveVirtualItem;

member this.RetrieveVirtualItem : System.Windows.Forms.RetrieveVirtualItemEventHandler 

Public Custom Event RetrieveVirtualItem As RetrieveVirtualItemEventHandler 

Tipo evento

RetrieveVirtualItemEventHandler

Eccezioni

InvalidOperationException

La proprietà Item non è impostata su un elemento quando viene gestito l'evento RetrieveVirtualItem.

Esempio

Nell'esempio di codice seguente viene illustrato un gestore per questo evento. In questo esempio listView1 deve ListViewItem visualizzare il quadrato del relativo indice. Questo esempio di codice fa parte di un esempio più ampio fornito per la VirtualMode proprietà .

//The basic VirtualMode function.  Dynamically returns a ListViewItem
//with the required properties; in this case, the square of the index.
void listView1_RetrieveVirtualItem(object sender, RetrieveVirtualItemEventArgs e)
{
    //Caching is not required but improves performance on large sets.
    //To leave out caching, don't connect the CacheVirtualItems event 
    //and make sure myCache is null.

    //check to see if the requested item is currently in the cache
    if (myCache != null && e.ItemIndex >= firstItem && e.ItemIndex < firstItem + myCache.Length)
    {
        //A cache hit, so get the ListViewItem from the cache instead of making a new one.
        e.Item = myCache[e.ItemIndex - firstItem];
    }
    else
    {
        //A cache miss, so create a new ListViewItem and pass it back.
        int x = e.ItemIndex * e.ItemIndex;
        e.Item = new ListViewItem(x.ToString());
    }
}

'The basic VirtualMode function.  Dynamically returns a ListViewItem
'with the required properties; in this case, the square of the index.
Private Sub listView1_RetrieveVirtualItem(ByVal sender As Object, ByVal e As RetrieveVirtualItemEventArgs) Handles listView1.RetrieveVirtualItem
    'Caching is not required but improves performance on large sets.
    'To leave out caching, don't connect the CacheVirtualItems event 
    'and make sure myCache is null.
    'check to see if the requested item is currently in the cache
    If Not (myCache Is Nothing) AndAlso e.ItemIndex >= firstItem AndAlso e.ItemIndex < firstItem + myCache.Length Then
        'A cache hit, so get the ListViewItem from the cache instead of making a new one.
        e.Item = myCache((e.ItemIndex - firstItem))
    Else
        'A cache miss, so create a new ListViewItem and pass it back.
        Dim x As Integer = e.ItemIndex * e.ItemIndex
        e.Item = New ListViewItem(x.ToString())
    End If


End Sub

Commenti

Quando un ListView oggetto è in modalità virtuale, crea ListViewItem oggetti in modo dinamico anziché usare la Items raccolta. Questo evento viene generato quando l'oggetto deve creare un ListViewItem oggetto . Un gestore per questo evento deve creare l'oggetto appropriato ListViewItem o recuperarlo dalla cache e passarlo di nuovo tramite la Item proprietà .

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.