ListViewItem.FindNearestItem メソッド

.NET Framework クラス ライブラリ リファレンス

ListViewItem.FindNearestItem メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

検索方向を指定して、最も近い項目を ListViewItem から検索します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function FindNearestItem ( _
    searchDirection As SearchDirectionHint _
) As ListViewItem

Visual Basic (使用法)

Dim instance As ListViewItem
Dim searchDirection As SearchDirectionHint
Dim returnValue As ListViewItem

returnValue = instance.FindNearestItem(searchDirection)

C#

public ListViewItem FindNearestItem (
    SearchDirectionHint searchDirection
)

C++

public:
ListViewItem^ FindNearestItem (
    SearchDirectionHint searchDirection
)

J#

public ListViewItem FindNearestItem (
    SearchDirectionHint searchDirection
)

JScript

public function FindNearestItem (
    searchDirection : SearchDirectionHint
) : ListViewItem

パラメータ

searchDirection

SearchDirectionHint 値の 1 つ。

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

例外

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

解説

指定した方向に項目が存在しない場合、FindNearestItem メソッドは null 参照 (Visual Basic では Nothing) を返します。

最も近い項目の識別方法は、アプリケーションを実行しているオペレーティング システムによって異なる場合があり、FindNearestItem の結果に影響します。

使用例

FindNearestItem メソッドを使用する方法を次のコード例に示します。この例を実行するには、findListView という名前の ListView が配置されている Windows フォームに、次のコード例を貼り付けます。View プロパティがアイコン ビューに設定されており、ListView に項目が追加されていることを確認してください。次に、findListView の MouseDown イベントを、この例の findListView_MouseDown メソッドに関連付けます。

Visual Basic

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 Not (info.Item Is
 Nothing) Then
        foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up)
    End If
    If Not (foundItem Is
 Nothing) Then
        label1.Text = "Previous Item: " + foundItem.Text

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

End Sub

C#

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";
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ListViewItem クラス
ListViewItem メンバ
System.Windows.Forms 名前空間