ListView.HitTest Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fournit des informations d'élément, à des coordonnées x et y données.

Surcharges

HitTest(Point)	Fournit des informations d'élément, à un point donné.
HitTest(Int32, Int32)	Fournit des informations d'élément, à des coordonnées x et y données.

HitTest(Point)

Source:

ListView.cs

Fournit des informations d'élément, à un point donné.

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

Paramètres

point

Point

Point auquel récupérer des informations d'élément. Les coordonnées sont relatives au coin supérieur gauche du contrôle.

Retours

ListViewHitTestInfo

Les informations d'élément, à un point donné.

Exceptions

ArgumentOutOfRangeException

Le point contient des coordonnées inférieures à 0.

Remarques

Utilisez cette méthode pour déterminer si un point se trouve dans un élément ou un sous-élément et où se trouve le point dans l’élément, par exemple sur l’étiquette ou la zone d’image. Si les coordonnées se trouvent en dehors du contrôle, l’objet retourné a la Location propriété « None » ; et les Item propriétés et SubItem sont définies sur null.ListViewHitTestInfo

HitTest(Int32, Int32)

Source:

ListView.cs

Fournit des informations d'élément, à des coordonnées x et y données.

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

Coordonnée x où récupérer des informations d'élément. La coordonnée est relative au coin supérieur gauche du contrôle.

y

Int32

Coordonnée y où récupérer des informations d'élément. La coordonnée est relative au coin supérieur gauche du contrôle.

Retours

ListViewHitTestInfo

Informations d'élément, en fonction des coordonnées x et y données.

Exceptions

ArgumentOutOfRangeException

La coordonnée x ou y est inférieure à 0.

Exemples

L’exemple de code suivant illustre l’utilisation de la HitTest méthode pour déterminer l’emplacement d’un événement de souris dans un ListView. Pour exécuter cet exemple, collez-le dans un Windows Form qui contient un ListView nommé listView1 rempli d’éléments. Associez l’événement MouseDown pour listView1 à la listView1_MouseDown méthode dans cet exemple.

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 se trouve dans un élément ou un sous-élément et où se trouve le point dans l’élément, par exemple sur l’étiquette ou la zone d’image. Si les coordonnées se trouvent en dehors du contrôle, l’objet retourné a la Location propriété « None » ; et les Item propriétés et SubItem sont définies sur null.ListViewHitTestInfo