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 値のいずれか 1 つ。

戻り値

ListViewItem

指定した検索方向にある、特定の座標に最も近い ListViewItem。

例外

InvalidOperationException

項目を格納する View の ListView プロパティが、SmallIcon または LargeIcon 以外の値に設定されています。

例

次のコード例は、FindNearestItem メソッドの使用方法を示します。 この例を実行するには、 という名前findListViewの を含む Windows フォームに次のコードをListView貼り付けます。 プロパティが View アイコン ビューに設定され、 に項目が設定されていることを ListView 確認します。 のイベントfindListViewをMouseDown、この例の 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結果に影響します。