DataGridView.HitTest メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridView.HitTest メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

行インデックス、列インデックスなど、x 座標と y 座標を指定して位置情報を返します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function HitTest ( _
    x As Integer, _
    y As Integer _
) As HitTestInfo

Visual Basic (使用法)

Dim instance As DataGridView
Dim x As Integer
Dim y As Integer
Dim returnValue As HitTestInfo

returnValue = instance.HitTest(x, y)

C#

public HitTestInfo HitTest (
    int x,
    int y
)

C++

public:
HitTestInfo^ HitTest (
    int x, 
    int y
)

J#

public HitTestInfo HitTest (
    int x, 
    int y
)

JScript

public function HitTest (
    x : int, 
    y : int
) : HitTestInfo

パラメータ

x

x 座標。

y

y 座標。

戻り値
位置情報を格納している DataGridView.HitTestInfo。

解説

このメソッドを使用すると、DataGridView コントロールのどの部分が指定された座標にあるかを確認できます。たとえば、このメソッドを呼び出して、マウスのクリックにより座標を指定すると、クリックされたセルの行インデックスと列インデックス、またはヘッダー セルかスクロール バーがクリックされたかどうかを確認できます。

使用例

このメソッドの使用方法を次のコード例に示します。この例は Columns プロパティのリファレンス トピックで取り上げている例の一部です。

Visual Basic

Private clickedCell As DataGridViewCell

Private Sub dataGridView1_MouseDown(ByVal
 sender As Object, _
    ByVal e As MouseEventArgs) Handles
 dataGridView1.MouseDown

    ' If the user right-clicks a cell, store it for use by the 
    ' shortcut menu.
    If e.Button = MouseButtons.Right Then
        Dim hit As DataGridView.HitTestInfo
 = _
            dataGridView1.HitTest(e.X, e.Y)
        If hit.Type = DataGridViewHitTestType.Cell Then
            clickedCell = _
                dataGridView1.Rows(hit.RowIndex).Cells(hit.ColumnIndex)
        End If
    End If

End Sub

C#

private DataGridViewCell clickedCell;

private void dataGridView1_MouseDown(object
 sender, MouseEventArgs e)
{
// If the user right-clicks a cell, store it for use by the shortcut
 menu.
    if (e.Button == MouseButtons.Right)
    {
        DataGridView.HitTestInfo hit = dataGridView1.HitTest(e.X, e.Y);
        if (hit.Type == DataGridViewHitTestType.Cell)
        {
            clickedCell =
                dataGridView1.Rows[hit.RowIndex].Cells[hit.ColumnIndex];
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
DataGridView.HitTestInfo
DataGridViewHitTestType
その他の技術情報
DataGridView コントロール (Windows フォーム)