Método SimpleShape.HitTest

Artigo
10/26/2012

Determina se um controle shape está localizado no ponto especificado na tela.

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

Sintaxe

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

public override bool HitTest(
    int x,
    int y
)

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

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

public override 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 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 ao recipiente do controle.

Exemplos

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

Private Sub Form1_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 = MousePosition.X
        py = MousePosition.Y
        hit = OvalShape1.HitTest(px, py)
        MsgBox(CStr(hit))
    End If
End Sub

private void form1_PreviewKeyDown(object sender, 
    System.Windows.Forms.PreviewKeyDownEventArgs e)
{
    if (e.KeyCode == Keys.Space)
    {
        int px;
        int py;
        bool hit;
        string result;
        px = MousePosition.X;
        py = MousePosition.Y;
        hit = ovalShape1.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.