SimpleShape.HitTest (Método)

Artículo
11/02/2012

Determina si un control de forma se encuentra en el punto especificado en la pantalla.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
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
Coordenada horizontal de la pantalla.

y
Tipo: System.Int32
Coordenada vertical de la pantalla.

Valor devuelto

Tipo: System.Boolean
true si el control de forma se sitúa en las coordenadas especificadas; si no, false.

Comentarios

Los parámetros de x y de y representan las coordenadas del mouse actual en relación a la pantalla, no al contenedor del control.

Ejemplos

El ejemplo siguiente muestra cómo utilizar el método de HitTest de control de OvalShape para determinar si el puntero del mouse está colocado sobre el control cuando se presiona la BARRA ESPACIADORA.

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);
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.