ListView.SearchForVirtualItem ListView.SearchForVirtualItem ListView.SearchForVirtualItem ListView.SearchForVirtualItem Event

정의

발생 경우를 ListView 가 가상 모드에는 검색이 수행 되 고 있습니다.Occurs when the ListView is in virtual mode and a search is taking place.

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 

예제

다음 코드 예제에서는이 멤버를 사용 하는 방법을 보여 줍니다.The following code example demonstrates the use of this member. 예제에서는 검색을 먼저 10 천 제곱의 목록에 지정 된 정수를 가장 가까운 항목을 반환합니다.In the example, a search returns the nearest match to a specified integer in a list of the first ten thousand squares. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 VirtualMode 속성입니다.This code example is part of a larger example provided for the VirtualMode property.

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

설명

이 이벤트가 발생할 때를 ListView 가 가상 모드 및 FindNearestItem 또는 FindItemWithText 메서드가 호출 됩니다.This event occurs when a ListView is in virtual mode and the FindNearestItem or FindItemWithText method is called. 이 이벤트를 처리 하는 경우는에서 제공 하는 항목의 목록에서 항목 계산 해야는 Items 속성과 일치 검색 조건 설정 하 고는 SearchForVirtualItemEventArgs.Index 속성의 인덱스에는 ListViewItem.When handling this event, you should calculate which item from the list of items supplied by the Items property matches the search criteria and set the SearchForVirtualItemEventArgs.Index property to the index of the ListViewItem. 항목을 제공 하지 않으면 FindNearestItem 하 고 FindItemWithText 돌아갑니다 null합니다.If an item is not provided, FindNearestItem and FindItemWithText will return null.

이벤트 처리에 대한 자세한 내용은 이벤트 처리 및 발생 을 참조하십시오.For more information about handling events, see Handling and Raising Events.

적용 대상