Shape.HitTest-Methode

Artikel
10/24/2012

Ruft Informationen über ein Linien-oder Formsteuerelement an der angegebenen Position auf dem Bildschirm ab.

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

Syntax

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

Parameter

x
Typ: System.Int32
Die horizontale Bildschirmkoordinate.

y
Typ: System.Int32
Die vertikale Bildschirmkoordinate.

Rückgabewert

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

Hinweise

Die x und y-Parameter stellen die aktuellen Mauskoordinaten relativ zum Bildschirm nicht relativ zu dem Container des Steuerelements dar.

Beispiele

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

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

.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.