ListView.HitTest ListView.HitTest ListView.HitTest ListView.HitTest Method

Définition

Fournit des informations d'élément, à des coordonnées x et y données.Provides item information, given an x- and y-coordinate.

Surcharges

HitTest(Point) HitTest(Point) HitTest(Point)

Fournit des informations d'élément, à un point donné.Provides item information, given a point.

HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32)

Fournit des informations d'élément, en fonction des coordonnées x et y données.Provides item information, given x- and y-coordinates.

HitTest(Point) HitTest(Point) HitTest(Point)

Fournit des informations d'élément, à un point donné.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

Paramètres

point
Point Point Point Point

Le Point à partir duquel récupérer les informations d’élément.The Point at which to retrieve the item information. Les coordonnées sont relatives au coin supérieur gauche du contrôle.The coordinates are relative to the upper-left corner of the control.

Retours

Les informations d'élément, à un point donné.The item information, given a point.

Exceptions

Le point contient des coordonnées inférieures à 0.The point contains coordinates that are less than 0.

Remarques

Utilisez cette méthode pour déterminer si un point est dans un élément ou un sous-élément et l’emplacement dans l’élément le point, comme sur l’étiquette ou zone d’image.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. Si les coordonnées se trouvent en dehors du contrôle, retourné ListViewHitTestInfo objet possède un Location propriété sur « None » ; et le Item et SubItem propriétés sont définies sur 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.

HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32)

Fournit des informations d'élément, en fonction des coordonnées x et y données.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

Paramètres

x
Int32 Int32 Int32 Int32

Coordonnée x où récupérer les informations d'élément.The x-coordinate at which to retrieve the item information. La coordonnée est relative au coin supérieur gauche du contrôle.The coordinate is relative to the upper-left corner of the control.

y
Int32 Int32 Int32 Int32

Coordonnée y où récupérer des informations d'élément.The y-coordinate at which to retrieve the item information. La coordonnée est relative au coin supérieur gauche du contrôle.The coordinate is relative to the upper-left corner of the control.

Retours

Informations d'élément, en fonction des coordonnées x et y données.The item information, given x- and y- coordinates.

Exceptions

La coordonnée x ou y est inférieure à 0.The x- or y-coordinate is less than 0.

Exemples

L’exemple de code suivant montre comment utiliser le HitTest méthode pour déterminer l’emplacement d’un événement de souris dans une ListView.The following code example demonstrates using the HitTest method to determine the location of a mouse event in a ListView. Pour exécuter cet exemple, collez-le dans un formulaire Windows qui contient un ListView nommé listView1 qui est rempli avec des éléments.To run this example, paste it into a Windows Form that contains a ListView named listView1 that is populated with items. Associer le MouseDown événement pour listView1 avec la listView1_MouseDown méthode dans cet exemple.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

Remarques

Utilisez cette méthode pour déterminer si un point est dans un élément ou un sous-élément, et où dans l’élément le point se trouve, comme sur l’étiquette ou zone d’image.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. Si les coordonnées se trouvent en dehors du contrôle, retourné ListViewHitTestInfo objet possède un Location propriété sur « None » ; et le Item et SubItem propriétés sont définies sur 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.

S’applique à