ListView.HitTest Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornece informações de item, considerando uma coordenada x e y.

Sobrecargas

Nome	Description
HitTest(Point)	Fornece informações de item, dado um ponto.
HitTest(Int32, Int32)	Fornece informações de item, dadas as coordenadas x e y.

HitTest(Point)

Origem:

ListView.cs

Fornece informações de 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 local em que as informações do item serão recuperadas. As coordenadas são relativas ao canto superior esquerdo do controle.

Retornos

ListViewHitTestInfo

As informações do item, dado um ponto.

Exceções

ArgumentOutOfRangeException

O ponto contém coordenadas inferiores a 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 terá uma Location propriedade "None"; e as propriedades e as ItemSubItem propriedades serão definidas como null.ListViewHitTestInfo

HitTest(Int32, Int32)

Origem:

ListView.cs

Fornece informações de item, dadas 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

ListViewHitTestInfo

As informações do item, dadas as coordenadas x e y.

Exceções

ArgumentOutOfRangeException

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 a localização de um evento do mouse em um ListView. Para executar este exemplo, cole-o em um Formulário do Windows que contém um ListView nome listView1 que é preenchido com itens. Associe o MouseDown evento ao listView1listView1_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 terá uma Location propriedade "None"; e as propriedades e as ItemSubItem propriedades serão definidas como null.ListViewHitTestInfo