SimpleShape.HitTest-Methode

Artikel
10/24/2012

Bestimmt, ob ein Formsteuerelement am angegebenen Punkt auf dem Bildschirm befindet.

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

Syntax

'Declaration
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

Parameter

x
Typ: System.Int32
Die horizontale Bildschirmkoordinate.

y
Typ: System.Int32
Die vertikale Bildschirmkoordinate.

Rückgabewert

Typ: System.Boolean
true , wenn das Formsteuerelement an den angegebenen Koordinaten befindet. andernfalls false.

Hinweise

Die x und y-Parameter stellen die aktuellen Mauskoordinaten relativ zum Bildschirm, nicht an den Container des Steuerelements dar.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die HitTest-Methode des OvalShape-Steuerelements verwendet, um zu ermitteln, ob sich der Mauszeiger über dem Steuerelement befindet, wenn die LEERTASTE gedrückt wird.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.