ListView.HitTest 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

提供指定之 x 和 y 座標的項目資訊。

多載

HitTest(Point)	提供指定之點的項目資訊。
HitTest(Int32, Int32)	提供指定之 x 和 y 座標的項目資訊。

HitTest(Point)

提供指定之點的項目資訊。

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(System::Drawing::Point point);

public System.Windows.Forms.ListViewHitTestInfo HitTest (System.Drawing.Point point);

member this.HitTest : System.Drawing.Point -> System.Windows.Forms.ListViewHitTestInfo

Public Function HitTest (point As Point) As ListViewHitTestInfo

參數

point

Point

要擷取項目資訊的 Point。 座標相對於控制項的左上角。

傳回

ListViewHitTestInfo

指定之點的項目資訊。

例外狀況

ArgumentOutOfRangeException

包含小於 0 之座標的點。

備註

使用這個方法可判斷某個點是否位於專案或子專案，以及該點所在的專案位置，例如標籤或影像區域。 如果座標位於 控制項之外，則傳 ListViewHitTestInfo 回的物件具有 Location 「None」 的屬性;且 Item 和 SubItem 屬性會設定為 null 。

HitTest(Int32, Int32)

提供指定之 x 和 y 座標的項目資訊。

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(int x, int y);

public System.Windows.Forms.ListViewHitTestInfo HitTest (int x, int y);

member this.HitTest : int * int -> System.Windows.Forms.ListViewHitTestInfo

Public Function HitTest (x As Integer, y As Integer) As ListViewHitTestInfo

參數

x

Int32

要擷取項目資訊的 x 座標。 座標相對於控制項的左上角。

y

Int32

要擷取項目資訊的 y 座標。 座標相對於控制項的左上角。

傳回

ListViewHitTestInfo

指定之 x 和 y 座標的項目資訊。

例外狀況

ArgumentOutOfRangeException

小於 0 的 x 或 y 座標。

範例

下列程式碼範例示範如何使用 HitTest 方法來判斷 中 ListView 滑鼠事件的位置。 若要執行此範例，請將它貼到 Windows Form 中，其中包含 ListView 填入專案的具名 listView1 。 在此範例中， listView1_MouseDown 將 MouseDown 的 listView1 事件與 方法產生關聯。

void HandleMouseDown(object sender, MouseEventArgs e)
{
    ListViewHitTestInfo info = listView1.HitTest(e.X, e.Y);
    MessageBox.Show(info.Location.ToString());
}

Private Sub HandleMouseDown(ByVal sender As Object, ByVal e As MouseEventArgs) _
        Handles Me.MouseDown, listView1.MouseDown

    Dim info As ListViewHitTestInfo = listView1.HitTest(e.X, e.Y)
    MessageBox.Show(info.Location.ToString())

End Sub

備註

使用這個方法可判斷某個點是否位於專案或子專案，以及該點所在專案的位置，例如標籤或影像區域。 如果座標位於 控制項之外，則傳 ListViewHitTestInfo 回的物件具有 Location 「None」 的屬性;且 Item 和 SubItem 屬性會設定為 null 。