ListView.HitTest Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece informações sobre o item, considerando um par de coordenadas X e Y.
Sobrecargas
HitTest(Point) |
Fornece informações do item, dado um ponto. |
HitTest(Int32, Int32) |
Fornece informações sobre o item, considerando as coordenadas x e y. |
HitTest(Point)
Fornece informações do item, dado um ponto.
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
O Point no qual recuperar as informações do item. As coordenadas são relativas ao canto superior esquerdo do controle.
Retornos
As informações do item, considerando um ponto.
Exceções
O ponto contêm coordenadas que são menores que 0.
Comentários
Use esse método para determinar se um ponto está em um item ou subitem e onde no item o ponto está localizado, como na área de rótulo ou imagem. Se as coordenadas estiverem localizadas fora do controle, o objeto retornado ListViewHitTestInfo terá uma Location propriedade de "None"; e as Item propriedades e SubItem serão definidas null
como .
Aplica-se a
HitTest(Int32, Int32)
Fornece informações sobre o item, considerando as coordenadas x e y.
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
A coordenada X na qual recuperar as informações do item. A coordenada é relativa ao canto superior esquerdo do controle.
- y
- Int32
A coordenada Y na qual recuperar as informações do item. A coordenada é relativa ao canto superior esquerdo do controle.
Retornos
As informações sobre o item, considerando as coordenadas X e Y.
Exceções
A coordenada x ou y é menor que 0.
Exemplos
O exemplo de código a seguir demonstra o uso do HitTest método para determinar o local de um evento do mouse em um ListView. Para executar este exemplo, cole-o em um Windows Form que contém um ListView nome listView1
que é preenchido com itens. Associe o MouseDown evento para listView1
ao listView1_MouseDown
método neste exemplo.
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
Comentários
Use esse método para determinar se um ponto está em um item ou subitem e onde no item o ponto está localizado, como na área de rótulo ou imagem. Se as coordenadas estiverem localizadas fora do controle, o objeto retornado ListViewHitTestInfo terá uma Location propriedade de "None"; e as Item propriedades e SubItem serão definidas null
como .