Shape.HitTest-Methode

Artikel
05/16/2015

Ruft Informationen zu einem Line- oder Shape-Steuerelement 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: Int32

Die horizontale Bildschirmkoordinate.

y
Typ: Int32

Die vertikale Bildschirmkoordinate.

Rückgabewert

Typ: Boolean
trueWenn das Linie oder Form-Steuerelement an den angegebenen Koordinaten befindet; andernfalls false.

Hinweise

Die x und y Parameter darstellen, die aktuellen Koordinaten relativ zum Bildschirm, nicht relativ zum Container des Steuerelements.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die HitTest Methode der LineShape Steuerelement, um zu bestimmen, ob sich der Mauszeiger über dem Steuerelement positioniert ist, 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.