ListView.HitTest Metoda

Definicja

Zawiera informacje o elemencie, pod kątem współrzędnych x i y.Provides item information, given an x- and y-coordinate.

Przeciążenia

HitTest(Point)

Zawiera informacje o elemencie, na których znajduje się punkt.Provides item information, given a point.

HitTest(Int32, Int32)

Zawiera informacje o elemencie, pod którymi współrzędne x i y.Provides item information, given x- and y-coordinates.

HitTest(Point)

Zawiera informacje o elemencie, na których znajduje się punkt.Provides item information, given a 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

Parametry

point
Point

, Z Point którego mają zostać pobrane informacje o elemencie.The Point at which to retrieve the item information. Współrzędne są względne w lewym górnym rogu kontrolki.The coordinates are relative to the upper-left corner of the control.

Zwraca

ListViewHitTestInfo

Informacje o elemencie, na których znajduje się punkt.The item information, given a point.

Wyjątki

Punkt zawiera współrzędne, które są mniejsze od 0.The point contains coordinates that are less than 0.

Uwagi

Użyj tej metody, aby określić, czy punkt znajduje się w elemencie, czy w elemencie, gdzie znajduje się punkt, na przykład w obszarze Etykieta lub obraz.Use this method to determine whether a point is in an item or subitem and where in the item the point is located, such as on the label or image area. Jeśli współrzędne znajdują się poza kontrolką, zwracany ListViewHitTestInfo obiekt ma Location Właściwość "none" (brak), a Item właściwości i SubItem są ustawione na null .If the coordinates are located outside the control, the returned ListViewHitTestInfo object has a Location property of "None"; and the Item and SubItem properties are set to null.

Dotyczy

HitTest(Int32, Int32)

Zawiera informacje o elemencie, pod którymi współrzędne x i y.Provides item information, given x- and y-coordinates.

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, z której mają zostać pobrane informacje o elemencie.The x-coordinate at which to retrieve the item information. Współrzędna jest względem lewego górnego rogu kontrolki.The coordinate is relative to the upper-left corner of the control.

y
Int32

Współrzędna y, w której mają zostać pobrane informacje o elemencie.The y-coordinate at which to retrieve the item information. Współrzędna jest względem lewego górnego rogu kontrolki.The coordinate is relative to the upper-left corner of the control.

Zwraca

ListViewHitTestInfo

Informacje o elemencie, pod którymi współrzędne x i y.The item information, given x- and y- coordinates.

Wyjątki

Współrzędna x lub y jest mniejsza od 0.The x- or y-coordinate is less than 0.

Przykłady

Poniższy przykład kodu demonstruje użycie metody, HitTest Aby określić lokalizację zdarzenia myszy w ListView .The following code example demonstrates using the HitTest method to determine the location of a mouse event in a ListView. Aby uruchomić ten przykład, wklej go do formularza systemu Windows zawierającego ListView nazwę listView1 , która jest wypełniana elementami.To run this example, paste it into a Windows Form that contains a ListView named listView1 that is populated with items. Skojarz MouseDown zdarzenie dla listView1 z listView1_MouseDown metodą w tym przykładzie.Associate the MouseDown event for listView1 with the listView1_MouseDown method in this example.

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 w elemencie, gdzie znajduje się punkt, na przykład w obszarze Etykieta lub obraz.Use this method to determine whether a point is in an item or subitem, and where in the item the point is located, such as on the label or image area. Jeśli współrzędne znajdują się poza kontrolką, zwracany ListViewHitTestInfo obiekt ma Location Właściwość "none" (brak), a Item właściwości i SubItem są ustawione na null .If the coordinates are located outside the control, the returned ListViewHitTestInfo object has a Location property of "None"; and the Item and SubItem properties are set to null.

Dotyczy