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 (朝指定的方向搜尋)。

例外狀況

InvalidOperationException

包含之 View 的 ListView 屬性設定為 SmallIcon 或 LargeIcon 以外的值。

範例

下列程式碼範例會示範如何使用 FindNearestItem 方法。 若要執行此範例，請將下列程式碼貼到包含具名 findListView 的 ListView Windows Form 中。 確定 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 。