Shape.HitTest-Methode

Článek
08/23/2008

Aktualisiert: November 2007

Ruft Informationen über ein Line- oder Shape-Steuerelement an der angegebenen Bildschirmposition 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
'Usage
Dim instance As Shape
Dim x As Integer
Dim y As Integer
Dim returnValue As Boolean

returnValue = instance.HitTest(x, y)

public abstract bool HitTest(
    int x,
    int y
)

public:
virtual bool HitTest(
    int x, 
    int y
) abstract

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 sich das Line- oder Shape-Steuerelement an den angegebenen Koordinaten befindet, andernfalls false.

Hinweise

Die Parameter x und y geben die aktuellen Mauskoordinaten relativ zum Bildschirm, nicht relativ vom Container des Steuerelements an.

Beispiele

Das folgende Beispiel veranschaulicht, wie Sie mit der HitTest-Methode des LineShape-Steuerelements ermitteln, ob der Mauszeiger beim Drücken der LEERTASTE über dem Steuerelement positioniert ist.

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

Berechtigungen

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.