ListViewItem.FindNearestItem(SearchDirectionHint) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Находит следующий элемент в объекте 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 – это элемент, ближайший к точке, заданной координатами x и y, при поиске в указанном направлении.

Исключения

InvalidOperationException

Свойство View содержащего объекта ListView имеет значение, отличное от SmallIcon или LargeIcon.

Примеры

В следующем примере кода показано, как использовать метод FindNearestItem. Чтобы выполнить этот пример, вставьте следующий код в форму Windows Forms, содержащую ListView объект с именем findListView. Убедитесь, что свойству 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.