Shape.HitTest メソッド

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

画面上の指定した位置にあるラインコントロールまたはシェイプコントロールに関する情報を取得します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public MustOverride Function HitTest ( _
    x As Integer, _
    y As Integer _
) As Boolean
'使用
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

パラメータ

x
型 : System.Int32

水平画面座標。

y
型 : System.Int32

垂直画面座標。

戻り値

型 : System.Boolean

指定した座標にラインコントロールまたはシェイプコントロールがある場合は true。それ以外の場合は false。

解説

x パラメータおよび y パラメータは、コントロールコンテナではなく、画面を基準とする現在のマウスの相対座標を表します。

例

LineShape コントロールの HitTest メソッドを使用して、Space キーが押されたときにポインタがコントロール上にあるかどうかを判断する方法を次の例に示します。

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