ListView.SearchForVirtualItem Olay

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

sanal modda olduğunda ListView ve bir arama yapıldığında gerçekleşir.

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 

Olay Türü

SearchForVirtualItemEventHandler

Örnekler

Aşağıdaki kod örneğinde bu üyenin kullanımı gösterilmektedir. Örnekte, bir arama ilk on bin kare listesinde belirtilen tamsayıya en yakın eşleşmeyi döndürür. Bu kod örneği, özelliği için VirtualMode sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Bu olay, bir ListView sanal modda olduğunda ve FindNearestItem veya FindItemWithText yöntemi çağrıldığında oluşur. Bu olayı işlerken, özelliği tarafından sağlanan öğeler listesinden hangi öğenin arama ölçütleri ile Items eşleştiği hesaplamalı ve özelliğini dizinine ListViewItemayarlamalısınızSearchForVirtualItemEventArgs.Index. Bir öğe sağlanmazsa FindNearestItem ve FindItemWithText döndürür null.

Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.