ListView.HitTest Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dostarcza informacje o elemencie, biorąc pod uwagę współrzędną x i y.

Przeciążenia

HitTest(Point)	Dostarcza informacje o elemencie, biorąc pod uwagę punkt.
HitTest(Int32, Int32)	Dostarcza informacje o elementach, biorąc pod uwagę współrzędne x i y.

HitTest(Point)

Dostarcza informacje o elemencie, biorąc pod uwagę punkt.

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

Element Point , w którym mają być pobierane informacje o elemencie. Współrzędne są względem lewego górnego rogu kontrolki.

Zwraca

ListViewHitTestInfo

Informacje o elemencie, biorąc pod uwagę punkt.

Wyjątki

ArgumentOutOfRangeException

Punkt zawiera współrzędne, które są mniejsze niż 0.

Uwagi

Użyj tej metody, aby określić, czy punkt znajduje się w elemencie, czy subitem oraz gdzie w elemencie znajduje się punkt, na przykład w obszarze etykiety lub obrazu. Jeśli współrzędne znajdują się poza kontrolką, zwrócony ListViewHitTestInfo obiekt ma Location właściwość "None", a Item właściwości i SubItem są ustawione na nullwartość .

HitTest(Int32, Int32)

Dostarcza informacje o elementach, biorąc pod uwagę współrzędne x i 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

Współrzędna x, przy której mają być pobierane informacje o elemencie. Współrzędna jest względna względem lewego górnego rogu kontrolki.

y

Int32

Współrzędna y, przy której mają być pobierane informacje o elemencie. Współrzędna jest względna względem lewego górnego rogu kontrolki.

Zwraca

ListViewHitTestInfo

Informacje o elemencie, podane współrzędne x i y.

Wyjątki

ArgumentOutOfRangeException

Współrzędna x lub y jest mniejsza niż 0.

Przykłady

Poniższy przykład kodu przedstawia użycie HitTest metody w celu określenia lokalizacji zdarzenia myszy w obiekcie ListView. Aby uruchomić ten przykład, wklej go w formularzu systemu Windows zawierającym nazwę listView1 wypełniona ListView elementami. MouseDown Skojarz zdarzenie z listView1 metodą w tym przykładzielistView1_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

Uwagi

Użyj tej metody, aby określić, czy punkt znajduje się w elemencie, czy subitem, i gdzie w elemencie znajduje się punkt, na przykład na etykiecie lub obszarze obrazu. Jeśli współrzędne znajdują się poza kontrolką, zwrócony ListViewHitTestInfo obiekt ma Location właściwość "None", a Item właściwości i SubItem są ustawione na nullwartość .