ListView.HitTest Method

Definition

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

Overloads

HitTest(Point)

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

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)

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
Public Function HitTest (point As Point) As ListViewHitTestInfo

Parameters

point
Point

Point auquel récupérer des 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.

Returns

ListViewHitTestInfo

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.

Remarks

Utilisez cette méthode pour déterminer si un point se trouve dans un élément ou un sous-élément et où le point se trouve dans l’élément, par exemple sur l’étiquette ou la 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 sont situées en dehors du contrôle, l’objet ListViewHitTestInfo retourné a une propriété Location de « None »; et les propriétés Item et SubItem 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)

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

Parameters

x
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

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.

Returns

ListViewHitTestInfo

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.

Examples

L’exemple de code suivant illustre l’utilisation de la méthode HitTest pour déterminer l’emplacement d’un événement de souris dans un 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 Windows Form qui contient une ListView nommée listView1 qui est remplie avec Items.To run this example, paste it into a Windows Form that contains a ListView named listView1 that is populated with items. Associez l’événement MouseDown pour listView1 à la méthode listView1_MouseDown 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

Remarks

Utilisez cette méthode pour déterminer si un point se trouve dans un élément ou un sous-élément, et où le point se trouve dans l’élément, par exemple sur l’étiquette ou la 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 sont situées en dehors du contrôle, l’objet ListViewHitTestInfo retourné a une propriété Location de « None »; et les propriétés Item et SubItem 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.

Applies to