ListView.HitTest Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Poskytuje informace o položce s souřadnicí x a y.

Přetížení

Name	Description
HitTest(Point)	Poskytuje informace o položce s daným bodem.
HitTest(Int32, Int32)	Poskytuje informace o položce, zadané souřadnice x a y.

HitTest(Point)

Zdroj:

ListView.cs

Poskytuje informace o položce s daným bodem.

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

Parametry

point

Point

Informace Point o položce se načtou. Souřadnice jsou relativní vzhledem k levému hornímu rohu ovládacího prvku.

Návraty

ListViewHitTestInfo

Informace o položce s daným bodem.

Výjimky

ArgumentOutOfRangeException

Bod obsahuje souřadnice, které jsou menší než 0.

Poznámky

Tuto metodu použijte k určení, zda je bod v položce nebo v podřízené položce a kde se bod nachází, například v popisku nebo oblasti obrázku. Pokud jsou souřadnice umístěny mimo ovládací prvek, vrácený ListViewHitTestInfo objekt má Location vlastnost "None"; a Item vlastnosti SubItem jsou nastaveny na null.

HitTest(Int32, Int32)

Zdroj:

ListView.cs

Poskytuje informace o položce, zadané souřadnice x a 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

Parametry

x

Int32

Souřadnice x, pro kterou chcete načíst informace o položce. Souřadnice je relativní vzhledem k levému hornímu rohu ovládacího prvku.

y

Int32

Souřadnice y, pro kterou chcete načíst informace o položce. Souřadnice je relativní vzhledem k levému hornímu rohu ovládacího prvku.

Návraty

ListViewHitTestInfo

Informace o položce, zadané souřadnice x a y.

Výjimky

ArgumentOutOfRangeException

Souřadnice x nebo y je menší než 0.

Příklady

Následující příklad kódu ukazuje použití HitTest metody k určení umístění události myši v .ListView Pokud chcete tento příklad spustit, vložte ho do formuláře Windows, který obsahuje ListView název listView1 naplněný položkami. Přidružte MouseDown událost pro listView1 metodu v tomto příkladu listView1_MouseDown .

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

Poznámky

Tuto metodu použijte k určení, zda je bod v položce nebo v podsítě a kde se v položce bod nachází, jako je například popisek nebo oblast obrázku. Pokud jsou souřadnice umístěny mimo ovládací prvek, vrácený ListViewHitTestInfo objekt má Location vlastnost "None"; a Item vlastnosti SubItem jsou nastaveny na null.