ListView.HitTest Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyediakan informasi item, diberikan koordinat x dan y.

Overload

HitTest(Point)	Menyediakan informasi item, diberikan titik.
HitTest(Int32, Int32)	Menyediakan informasi item, yang diberikan koordinat x- dan y.

HitTest(Point)

Menyediakan informasi item, diberikan titik.

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

Parameter

point

Point

tempat Point untuk mengambil informasi item. Koordinat relatif terhadap sudut kiri atas kontrol.

Mengembalikan

ListViewHitTestInfo

Informasi item, diberikan titik.

Pengecualian

ArgumentOutOfRangeException

Titik berisi koordinat yang kurang dari 0.

Keterangan

Gunakan metode ini untuk menentukan apakah titik berada dalam item atau subitem dan di mana dalam item titik berada, seperti pada label atau area gambar. Jika koordinat terletak di luar kontrol, objek yang dikembalikan ListViewHitTestInfo memiliki properti "Tidak Ada"; dan Item properti dan SubItem diatur ke nullLocation .

HitTest(Int32, Int32)

Menyediakan informasi item, yang diberikan koordinat x- dan 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

Parameter

x

Int32

Koordinat x untuk mengambil informasi item. Koordinat relatif terhadap sudut kiri atas kontrol.

y

Int32

Koordinat y untuk mengambil informasi item. Koordinat relatif terhadap sudut kiri atas kontrol.

Mengembalikan

ListViewHitTestInfo

Informasi item, diberikan koordinat x- dan y- .

Pengecualian

ArgumentOutOfRangeException

Koordinat x atau y kurang dari 0.

Contoh

Contoh kode berikut menunjukkan menggunakan HitTest metode untuk menentukan lokasi peristiwa mouse di ListView. Untuk menjalankan contoh ini, tempelkan ke dalam Formulir Windows yang berisi ListView nama listView1 yang diisi dengan item. Kaitkan MouseDown peristiwa untuk listView1 dengan listView1_MouseDown metode dalam contoh ini.

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

Keterangan

Gunakan metode ini untuk menentukan apakah titik berada dalam item atau subitem, dan di mana dalam item titik berada, seperti pada label atau area gambar. Jika koordinat terletak di luar kontrol, objek yang dikembalikan ListViewHitTestInfo memiliki properti "Tidak Ada"; dan Item properti dan SubItem diatur ke nullLocation .