ListViewItem.FindNearestItem(SearchDirectionHint) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

ListViewItem.cs

지정된 방향으로 검색하여 ListViewItem에서 다음 항목을 찾습니다.

public:
 System::Windows::Forms::ListViewItem ^ FindNearestItem(System::Windows::Forms::SearchDirectionHint searchDirection);

public System.Windows.Forms.ListViewItem? FindNearestItem (System.Windows.Forms.SearchDirectionHint searchDirection);

member this.FindNearestItem : System.Windows.Forms.SearchDirectionHint -> System.Windows.Forms.ListViewItem

Public Function FindNearestItem (searchDirection As SearchDirectionHint) As ListViewItem

매개 변수

searchDirection

SearchDirectionHint

SearchDirectionHint 값 중 하나입니다.

반환

ListViewItem

지정된 방향으로 검색할 때 지정된 좌표에 가장 가까운 ListViewItem입니다.

예외

InvalidOperationException

포함하는 View의 ListView 속성이 SmallIcon 또는 LargeIcon 이외의 값으로 설정된 경우

예제

다음 코드 예제에서는 FindNearestItem 메서드를 사용하는 방법을 보여 줍니다. 이 예제를 실행하려면 다음 코드를 라는 가 findListView포함된 Windows Form에 붙여넣습니다ListView. 속성이 View 아이콘 보기로 설정되어 있고 가 ListView 항목으로 채워져 있는지 확인합니다. 이 예제에서 MouseDown 의 findListView 이벤트를 메서드와 findListView_MouseDown 연결합니다.

void findListView_MouseDown(object sender, MouseEventArgs e)
{
    ListViewHitTestInfo info = findListView.HitTest(e.X, e.Y);
    ListViewItem foundItem = null;
    if (info.Item != null)
        foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up);
    if (foundItem != null)
        label1.Text = "Previous Item: " + foundItem.Text;

    else
        label1.Text = "No item found";
}

Private Sub findListView_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs)


    Dim info As ListViewHitTestInfo = findListView.HitTest(e.X, e.Y)
    Dim foundItem As ListViewItem = Nothing
    If (info.Item IsNot Nothing) Then
        foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up)
    End If
    If (foundItem IsNot Nothing) Then
        label1.Text = "Previous Item: " + foundItem.Text

    Else
        label1.Text = "No item found"
    End If

End Sub

설명

FindNearestItem 지정된 방향으로 항목이 없으면 메서드가 를 반환 null 합니다.

가장 가까운 항목을 식별 하는 애플리케이션에서 실행 중인 운영 체제에 따라 달라질 수 있습니다 및 결과는 영향이 FindNearestItem합니다.