ListView.HitTest Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Fornece informação sobre o item, dadas coordenadas x e y.

Sobrecargas

Name Description
HitTest(Point)

Fornece informação sobre o item, dado um ponto.
HitTest(Int32, Int32)

Fornece informação sobre itens, dadas coordenadas x e y.

HitTest(Point)

Fornece informação sobre o 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 momento em que se deve obter a informação do artigo. As coordenadas são relativas ao canto superior esquerdo do controlo.

Devoluções

ListViewHitTestInfo

A informação do item, dado um ponto.

Exceções

ArgumentOutOfRangeException

O ponto contém coordenadas que são inferiores a 0.

Observações

Use este método para determinar se um ponto está num item ou subitem e onde o ponto está localizado, como na área do rótulo ou da imagem. Se as coordenadas estiverem localizadas fora do controlo, o objeto devolvido ListViewHitTestInfo tem a Location propriedade "Nenhuma"; e as Item propriedades e SubItem são definidas para null.

Aplica-se a

HitTest(Int32, Int32)

Fornece informação sobre itens, dadas 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 para recuperar a informação do item. A coordenada é relativa ao canto superior esquerdo do controlo.

y
Int32

A coordenada y onde se deve recuperar a informação do item. A coordenada é relativa ao canto superior esquerdo do controlo.

Devoluções

ListViewHitTestInfo

A informação 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 seguinte demonstra a utilização do HitTest método para determinar a localização de um evento de rato num ListView. Para executar este exemplo, cole-o num formulário Windows que contenha um ListView chamado 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

Observações

Use este método para determinar se um ponto está num item ou subitem, e onde o ponto está localizado, como na área do rótulo ou imagem. Se as coordenadas estiverem localizadas fora do controlo, o objeto devolvido ListViewHitTestInfo tem a Location propriedade "Nenhuma"; e as Item propriedades e SubItem são definidas para null.

Aplica-se a