Método Shape.HitTest

Artigo
10/26/2012

Obtém informações sobre um controle de linha ou forma na posição especificada na tela.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
Public MustOverride Function HitTest ( _
    x As Integer, _
    y As Integer _
) As Boolean

public abstract bool HitTest(
    int x,
    int y
)

public:
virtual bool HitTest(
    int x, 
    int y
) abstract

abstract HitTest : 
        x:int * 
        y:int -> bool

public abstract function HitTest(
    x : int, 
    y : int
) : boolean

Parâmetros

x
Tipo: System.Int32
A coordenada horizontal de tela.

y
Tipo: System.Int32
A coordenada vertical de tela.

Valor de retorno

Tipo: System.Boolean
true Se o controle de linha ou forma está localizado nas coordenadas especificadas; Caso contrário, false.

Comentários

O x e y parâmetros representam as coordenadas do mouse atual em relação à tela, não em relação ao container do controle.

Exemplos

O exemplo a seguir demonstra como usar o HitTest método da LineShape controle para determinar se o ponteiro é posicionado sobre o controle quando a barra de espaços for pressionada.

Private Sub LineHitTestForm_PreviewKeyDown(
    ByVal sender As Object, 
    ByVal e As System.Windows.Forms.PreviewKeyDownEventArgs
  ) Handles Me.PreviewKeyDown

    If e.KeyCode = Keys.Space Then
        Dim px As Integer
        Dim py As Integer
        Dim hit As Boolean
        px = LineHitTestForm.MousePosition.X
        py = LineHitTestForm.MousePosition.Y
        hit = LineShape1.HitTest(px, py)
        MsgBox(CStr(hit))
    End If
End Sub

private void LineHitTestForm_PreviewKeyDown(object sender, 
    System.Windows.Forms.PreviewKeyDownEventArgs e)
{
    if (e.KeyCode == Keys.Space)
    {
        int px;
        int py;
        bool hit;
        string result;
        px = LineHitTestForm.MousePosition.X;
        py = LineHitTestForm.MousePosition.Y;
        hit = lineShape1.HitTest(px, py);
        result = hit.ToString();
        MessageBox.Show(result);
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.