共用方式為


ListViewItem.FindNearestItem(SearchDirectionHint) 方法

定義

ListViewItem 中尋找下一個項目 (朝指定的方向搜尋)。

public:
 System::Windows::Forms::ListViewItem ^ FindNearestItem(System::Windows::Forms::SearchDirectionHint searchDirection);
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 (朝指定的方向搜尋)。

例外狀況

包含之 ViewListView 屬性設定為 SmallIconLargeIcon 以外的值。

範例

下列程式碼範例會示範如何使用 FindNearestItem 方法。 若要執行此範例,請將下列程式碼貼到包含具名 findListViewListView Windows Form 中。 確定 View 屬性已設定為圖示檢視,且 ListView 已填入專案。 在此範例中,將 的 MouseDown 事件 findListViewfindListView_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

適用於