ListView.SearchForVirtualItem Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce cuando el control ListView está en modo virtual y se está realizando una búsqueda.

C#

public event System.Windows.Forms.SearchForVirtualItemEventHandler SearchForVirtualItem;

C#

public event System.Windows.Forms.SearchForVirtualItemEventHandler? SearchForVirtualItem;

Tipo de evento

SearchForVirtualItemEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, una búsqueda devuelve la coincidencia más cercana a un entero especificado en una lista de los primeros diez mil cuadrados. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la VirtualMode propiedad .

C#

//This event handler enables search functionality, and is called
//for every search request when in Virtual mode.
void listView1_SearchForVirtualItem(object sender, SearchForVirtualItemEventArgs e)
{
    //We've gotten a search request.
    //In this example, finding the item is easy since it's
    //just the square of its index.  We'll take the square root
    //and round.
    double x = 0;
    if (Double.TryParse(e.Text, out x)) //check if this is a valid search
    {
        x = Math.Sqrt(x);
        x = Math.Round(x);
        e.Index = (int)x;
    }
    //If e.Index is not set, the search returns null.
    //Note that this only handles simple searches over the entire
    //list, ignoring any other settings.  Handling Direction, StartIndex,
    //and the other properties of SearchForVirtualItemEventArgs is up
    //to this handler.
}

Comentarios

Este evento se produce cuando ListView se encuentra en modo virtual y se llama al FindNearestItem método o FindItemWithText . Al controlar este evento, debe calcular qué elemento de la lista de elementos proporcionados por la Items propiedad coincide con los criterios de búsqueda y establecer la SearchForVirtualItemEventArgs.Index propiedad en el índice de ListViewItem. Si no se proporciona FindNearestItem un elemento y FindItemWithText devolverá null.

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

Se aplica a