ListView.HitTest Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Proporciona información acerca de los elementos basándose en las coordenadas X e Y dadas.

Sobrecargas

HitTest(Point)	Proporciona información acerca de los elementos basándose en el punto dado.
HitTest(Int32, Int32)	Proporciona información acerca de los elementos basándose en las coordenadas x e y dadas.

HitTest(Point)

Proporciona información acerca de los elementos basándose en el punto dado.

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

Parámetros

point

Point

Point en que se va a recuperar la información acerca de los elementos. Las coordenadas son relativas a la esquina superior izquierda del control.

Devoluciones

ListViewHitTestInfo

Información acerca de los elementos basándose en el punto dado.

Excepciones

ArgumentOutOfRangeException

El punto contiene coordenadas que son menores que 0.

Comentarios

Use este método para determinar si un punto está en un elemento o subelemento y dónde se encuentra el punto, como en el área de etiqueta o imagen. Si las coordenadas se encuentran fuera del control, el objeto devuelto ListViewHitTestInfo tiene una Location propiedad de "None"; y las Item propiedades y SubItem se establecen en null.

HitTest(Int32, Int32)

Proporciona información acerca de los elementos basándose en las coordenadas x e y dadas.

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. La coordenada es relativa a la esquina superior izquierda del control.

y

Int32

Coordenada y en que se va a recuperar la información acerca del elemento. La coordenada es relativa a la esquina superior izquierda del control.

Devoluciones

ListViewHitTestInfo

Información acerca de los elementos basándose en las coordenadas X e Y dadas.

Excepciones

ArgumentOutOfRangeException

La coordenada x o y es menor que 0.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del HitTest método para determinar la ubicación de un evento del mouse en .ListView Para ejecutar este ejemplo, péguelo en un formulario Windows Forms que contenga un ListView nombre listView1 que se rellena con elementos. Asocie el MouseDown evento para listView1 con el listView1_MouseDown método en este ejemplo.

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 está en un elemento o un subelemento, y dónde se encuentra el punto, como en el área de etiqueta o imagen. Si las coordenadas se encuentran fuera del control, el objeto devuelto ListViewHitTestInfo tiene una Location propiedad de "None"; y las Item propiedades y SubItem se establecen en null.