ListView.SearchForVirtualItem Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer de ListView virtuele modus zich bevindt en er een zoekopdracht plaatsvindt.
public:
event System::Windows::Forms::SearchForVirtualItemEventHandler ^ SearchForVirtualItem;
public event System.Windows.Forms.SearchForVirtualItemEventHandler SearchForVirtualItem;
public event System.Windows.Forms.SearchForVirtualItemEventHandler? SearchForVirtualItem;
member this.SearchForVirtualItem : System.Windows.Forms.SearchForVirtualItemEventHandler
Public Custom Event SearchForVirtualItem As SearchForVirtualItemEventHandler
Gebeurtenistype
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van dit lid. In het voorbeeld retourneert een zoekopdracht de dichtstbijzijnde overeenkomst met een opgegeven geheel getal in een lijst met de eerste tienduizend vierkanten. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de VirtualMode eigenschap.
//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.
}
'This event handler enables search functionality, and is called
'for every search request when in Virtual mode.
Private Sub listView1_SearchForVirtualItem(ByVal sender As Object, ByVal e As SearchForVirtualItemEventArgs) Handles listView1.SearchForVirtualItem
'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.
Dim x As Double = 0
If [Double].TryParse(e.Text, x) Then 'check if this is a valid search
x = Math.Sqrt(x)
x = Math.Round(x)
e.Index = Fix(x)
End If
'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.
End Sub
Opmerkingen
Deze gebeurtenis treedt op wanneer een ListView zich in de virtuele modus bevindt en de FindNearestItem of FindItemWithText methode wordt aangeroepen. Bij het afhandelen van deze gebeurtenis moet u berekenen welk item uit de lijst met items die door de Items eigenschap zijn opgegeven, overeenkomt met de zoekcriteria en de SearchForVirtualItemEventArgs.Index eigenschap instellen op de index van de ListViewItem. Als er geen item is opgegeven FindNearestItem en FindItemWithText wordt geretourneerd null.
Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.