Shape.HitTest (Método)

Artículo
05/17/2015

Obtiene información sobre un control de forma o línea en un punto especificado de la pantalla.

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

Sintaxis

'Declaración
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: Int32

Coordenada horizontal de la pantalla.

y
Tipo: Int32

Coordenada vertical de la pantalla.

Valor devuelto

Tipo: Boolean
true si el control de línea o forma se encuentra en las coordenadas especificadas; en caso contrario, false.

Comentarios

El x y y parámetros representan las coordenadas actuales del mouse (ratón) en relación con la pantalla, no en relación con el contenedor del control.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el HitTest método de la LineShape control para determinar si se coloca el puntero sobre el control cuando se presiona la barra espaciadora.

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

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.