ListView.HitTest Método

Definición

Proporciona información acerca de los elementos basándose en las coordenadas X e Y dadas.Provides item information, given an x- and y-coordinate.

Sobrecargas

HitTest(Point)

Proporciona información acerca de los elementos basándose en el punto dado.Provides item information, given a point.

HitTest(Int32, Int32)

Proporciona información acerca de los elementos basándose en las coordenadas X e Y dadas.Provides item information, given x- and y-coordinates.

HitTest(Point)

Proporciona información acerca de los elementos basándose en el punto dado.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

Parámetros

point
Point

Point en que se va a recuperar la información acerca de los elementos.The Point at which to retrieve the item information. Las coordenadas son relativas a la esquina superior izquierda del control.The coordinates are relative to the upper-left corner of the control.

Devoluciones

Información acerca de los elementos basándose en el punto dado.The item information, given a point.

Excepciones

El punto contiene coordenadas que son menores que 0.The point contains coordinates that are less than 0.

Comentarios

Utilice este método para determinar si un punto está en un elemento o subelemento y dónde se encuentra el punto en el elemento, como en el área de etiqueta o imagen.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 las coordenadas se encuentran fuera del control, el objeto ListViewHitTestInfo devuelto tiene una propiedad Location de "none"; y las propiedades Item y SubItem se establecen en 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)

Proporciona información acerca de los elementos basándose en las coordenadas X e Y dadas.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

Parámetros

x
Int32

Coordenada X en que se va a recuperar la información acerca del elemento.The x-coordinate at which to retrieve the item information. La coordenada es relativa a la esquina superior izquierda del control.The coordinate is relative to the upper-left corner of the control.

y
Int32

Coordenada Y en que se va a recuperar la información acerca del elemento.The y-coordinate at which to retrieve the item information. La coordenada es relativa a la esquina superior izquierda del control.The coordinate is relative to the upper-left corner of the control.

Devoluciones

Información acerca de los elementos basándose en las coordenadas X e Y dadas.The item information, given x- and y- coordinates.

Excepciones

La coordenada x o y es menor que 0.The x- or y-coordinate is less than 0.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método HitTest para determinar la ubicación de un evento del mouse en un ListView.The following code example demonstrates using the HitTest method to determine the location of a mouse event in a ListView. Para ejecutar este ejemplo, péguelo en un formulario de Windows Forms que contenga un ListView denominado listView1 que se rellene con elementos.To run this example, paste it into a Windows Form that contains a ListView named listView1 that is populated with items. Asocie el evento MouseDown para listView1 con el método listView1_MouseDown en este ejemplo.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

Comentarios

Utilice este método para determinar si un punto se encuentra en un elemento o subelemento, y dónde se encuentra el punto en el elemento, como en el área de etiqueta o imagen.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 las coordenadas se encuentran fuera del control, el objeto ListViewHitTestInfo devuelto tiene una propiedad Location de "none"; y las propiedades Item y SubItem se establecen en 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.

Se aplica a