ListView.HitTest Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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)
- Source:
- ListView.cs
- Source:
- ListView.cs
- Source:
- ListView.cs
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
Información acerca de los elementos basándose en el punto dado.
Excepciones
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
.
Se aplica a
HitTest(Int32, Int32)
- Source:
- ListView.cs
- Source:
- ListView.cs
- Source:
- ListView.cs
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
Información acerca de los elementos basándose en las coordenadas X e Y dadas.
Excepciones
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
.