Export (0) Print
Expand All

Shape.HitTest Method

Gets information about a line or shape control at the specified position on the screen.

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

public abstract bool HitTest(
	int x,
	int y
)

Parameters

x
Type: System.Int32

The horizontal screen coordinate.

y
Type: System.Int32

The vertical screen coordinate.

Return Value

Type: System.Boolean
true if the line or shape control is located at the specified coordinates; otherwise, false.

The x and y parameters represent the current mouse coordinates relative to the screen, not relative to the control's container.

The following example demonstrates how to use the HitTest method of the LineShape control to determine whether the pointer is positioned over the control when the SPACEBAR is pressed.

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

Show:
© 2014 Microsoft