DataGridView.CellContextMenuStripNeeded イベントとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

DataGridView.CellContextMenuStripNeeded イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

セルのショートカットメニューが必要な場合に発生します。

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

Visual Basic (宣言)

Public Event CellContextMenuStripNeeded As
 DataGridViewCellContextMenuStripNeededEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellContextMenuStripNeededEventHandler

AddHandler instance.CellContextMenuStripNeeded, handler

public event DataGridViewCellContextMenuStripNeededEventHandler
 CellContextMenuStripNeeded

C++

public:
event DataGridViewCellContextMenuStripNeededEventHandler^ CellContextMenuStripNeeded
 {
    void add (DataGridViewCellContextMenuStripNeededEventHandler^
 value);
    void remove (DataGridViewCellContextMenuStripNeededEventHandler^
 value);
}

/** @event */
public void add_CellContextMenuStripNeeded
 (DataGridViewCellContextMenuStripNeededEventHandler value)

/** @event */
public void remove_CellContextMenuStripNeeded
 (DataGridViewCellContextMenuStripNeededEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

CellContextMenuStripNeeded イベントは、DataGridView コントロールの DataSource プロパティが設定されているか、VirtualMode プロパティが true の場合にだけ発生します。

CellContextMenuStripNeeded イベントを処理すると、ユーザーがセルを右クリックするたびに、ハンドラで指定したショートカットメニューが表示されます。これは、セルの現在の状態または値によって決定されたショートカットメニューを表示する場合に便利です。

CellContextMenuStripNeeded イベントは、プログラムによって、またはユーザーがセルを右クリックして、DataGridViewCell.ContextMenuStrip プロパティの値が取得されたときにも発生します。

DataGridViewCellEventArgs.ColumnIndex プロパティと RowIndex プロパティを使用すると、セルの状態または値を確認し、この情報を使用して DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip プロパティを変更または修正できます。このプロパティは、セルの ContextMenuStrip プロパティの値によって初期化され、イベントの値によってオーバーライドされます。

大量のデータを処理するときは、CellContextMenuStripNeeded イベントを処理してください。この結果、複数のセルに対してセルの ContextMenuStrip 値を設定することによるパフォーマンスの低下を防止できます。詳細については、「Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

行の ContextMenuStrip プロパティを設定するか、RowContextMenuStripNeeded イベントを処理して、個別のセルではなく個別の行にショートカットメニューを指定することもできます。セルの ContextMenuStrip プロパティの設定は、行の ContextMenuStrip プロパティの設定をオーバーライドし、CellContextMenuStripNeeded イベントは、RowContextMenuStripNeeded イベントと行の ContextMenuStrip プロパティの設定の両方をオーバーライドします。ただし、セルのショートカットメニューに null 参照 (Visual Basic では Nothing) を指定すると、行のショートカットメニューがオーバーライドされるのを回避できます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

CellContextMenuStripNeeded イベントハンドラを使用して、ユーザーがセルを右クリックしたときに使用されるカスタムショートカットメニューを表示するコード例を次に示します。

Visual Basic

Private WithEvents wholeTable As
 New ToolStripMenuItem()
Private WithEvents lookUp As
 New ToolStripMenuItem()
Private strip As ContextMenuStrip
Private cellErrorText As String

Private Sub dataGridView1_CellContextMenuStripNeeded(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellContextMenuStripNeededEventArgs)
 _
    Handles dataGridView1.CellContextMenuStripNeeded

    cellErrorText = String.Empty

    If strip Is Nothing
 Then
        strip = New ContextMenuStrip()
        lookUp.Text = "Look Up"
        wholeTable.Text = "See Whole Table"
        strip.Items.Add(lookUp)
        strip.Items.Add(wholeTable)
    End If
    e.ContextMenuStrip = strip
End Sub

Private Sub wholeTable_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) Handles wholeTable.Click
    dataGridView1.DataSource = Populate("Select * from employees",
 True)
End Sub

Private theCellImHoveringOver As DataGridViewCellEventArgs

Private Sub dataGridView1_CellMouseEnter(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellMouseEnter

    theCellImHoveringOver = e
End Sub

Private cellErrorLocation As DataGridViewCellEventArgs

Private Sub lookUp_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) Handles lookUp.Click
    Try
        dataGridView1.DataSource = Populate("Select * from employees
 where " & _
            dataGridView1.Columns(theCellImHoveringOver.ColumnIndex).Name & "
 = '" & _
            dataGridView1.Rows(theCellImHoveringOver.RowIndex).Cells(theCellImHoveringOver.ColumnIndex).Value.ToString()
 & _
            "'", True)
    Catch ex As SqlException
        cellErrorText = "Can't look this cell up"
        cellErrorLocation = theCellImHoveringOver
    End Try
End Sub

Private Sub dataGridView1_CellErrorTextNeeded(ByVal
 sender As Object, _
            ByVal e As DataGridViewCellErrorTextNeededEventArgs)
 _
            Handles dataGridView1.CellErrorTextNeeded
    If (Not cellErrorLocation Is
 Nothing) Then
        If e.ColumnIndex = cellErrorLocation.ColumnIndex AndAlso
 _
            e.RowIndex = cellErrorLocation.RowIndex Then
            e.ErrorText = cellErrorText
        End If
    End If
End Sub

Private Function Populate(ByVal
 query As String, ByVal
 resetUnsharedCounter As Boolean) As DataTable

    If resetUnsharedCounter Then
        ResetCounter()
    End If

    ' Alter the data source as necessary
    Dim adapter As New SqlDataAdapter(query,
 _
        New SqlConnection("Integrated Security=SSPI;Persist
 Security Info=False;" & _
        "Initial Catalog=Northwind;Data Source=localhost"))

    Dim table As New DataTable()
    table.Locale = System.Globalization.CultureInfo.InvariantCulture
    adapter.Fill(table)
    Return table
End Function

Private count As New Label()
Private unsharedRowCounter As Integer

Private Sub ResetCounter()
    unsharedRowCounter = 0
    count.Text = unsharedRowCounter.ToString()
End Sub

private ToolStripMenuItem wholeTable = new
 ToolStripMenuItem();
private ToolStripMenuItem lookUp = new ToolStripMenuItem();
private ContextMenuStrip strip;
private string cellErrorText;

private void dataGridView1_CellContextMenuStripNeeded(object
 sender,
    DataGridViewCellContextMenuStripNeededEventArgs e)
{
    cellErrorText = String.Empty;

    if (strip == null)
    {
        strip = new ContextMenuStrip();
        lookUp.Text = "Look Up";
        wholeTable.Text = "See Whole Table";
        strip.Items.Add(lookUp);
        strip.Items.Add(wholeTable);
    }
    e.ContextMenuStrip = strip;
}

private void wholeTable_Click(object sender,
 EventArgs e)
{
    dataGridView1.DataSource = Populate("Select * from employees", true);
}

private DataGridViewCellEventArgs theCellImHoveringOver;

private void dataGridView1_CellMouseEnter(object
 sender, DataGridViewCellEventArgs e)
{
    theCellImHoveringOver = e;
}

private DataGridViewCellEventArgs cellErrorLocation;

private void lookUp_Click(object sender, EventArgs
 e)
{
    try
    {
        dataGridView1.DataSource = Populate("Select * from employees where "
 +
            dataGridView1.Columns[theCellImHoveringOver.ColumnIndex].Name + "
 = '" +
            dataGridView1.Rows[theCellImHoveringOver.RowIndex].
            Cells[theCellImHoveringOver.ColumnIndex].Value + "'",
            true);
    }
    catch (SqlException)
    {
        cellErrorText = "Can't look this cell up";
        cellErrorLocation = theCellImHoveringOver;
    }
}

private void dataGridView1_CellErrorTextNeeded(object
 sender,
    DataGridViewCellErrorTextNeededEventArgs e)
{
    if (cellErrorLocation != null)
    {
        if (e.ColumnIndex == cellErrorLocation.ColumnIndex &&
            e.RowIndex == cellErrorLocation.RowIndex)
        {
            e.ErrorText = cellErrorText;
        }
    }
}

private DataTable Populate(string query, bool
 resetUnsharedCounter)
{
    if (resetUnsharedCounter)
    {
        ResetCounter();
    }

    // Alter the data source as necessary
    SqlDataAdapter adapter = new SqlDataAdapter(query,
        new SqlConnection("Integrated Security=SSPI;Persist
 Security Info=False;" +
        "Initial Catalog=Northwind;Data Source=localhost"));

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);
    return table;
}

private Label count = new Label();
private int unsharedRowCounter;

private void ResetCounter()
{
    unsharedRowCounter = 0;
    count.Text = unsharedRowCounter.ToString();
}

C++

ToolStripMenuItem^ wholeTable;
ToolStripMenuItem^ lookUp;
System::Windows::Forms::ContextMenuStrip^ strip;
String^ cellErrorText;

void dataGridView1_CellContextMenuStripNeeded( Object^ /*sender*/
,
    DataGridViewCellContextMenuStripNeededEventArgs^ e )
{
    cellErrorText = String::Empty;
    if ( strip == nullptr )
    {
        strip = gcnew System::Windows::Forms::ContextMenuStrip;
        lookUp->Text = L"Look Up";
        wholeTable->Text = L"See Whole Table";
        strip->Items->Add( lookUp );
        strip->Items->Add( wholeTable );
    }

    e->ContextMenuStrip = strip;
}

void wholeTable_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
    dataGridView1->DataSource = Populate( L"Select * from employees",
 true );
}

DataGridViewCellEventArgs^ theCellImHoveringOver;
void dataGridView1_CellMouseEnter( Object^ /*sender*/, DataGridViewCellEventArgs^
 e )
{
    theCellImHoveringOver = e;
}

DataGridViewCellEventArgs^ cellErrorLocation;
void lookUp_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
    try
    {
        dataGridView1->DataSource = Populate( String::Format( L"Select *
 from employees where {0} = '{1}'", dataGridView1->Columns[ theCellImHoveringOver->ColumnIndex
 ]->Name, dataGridView1->Rows[ theCellImHoveringOver->RowIndex ]->Cells[ theCellImHoveringOver->ColumnIndex ]->Value ), true
 );
    }
    catch ( ... ) 
    {
        cellErrorText = L"Can't look this cell up";
        cellErrorLocation = theCellImHoveringOver;
    }

}

void dataGridView1_CellErrorTextNeeded( Object^ /*sender*/, DataGridViewCellErrorTextNeededEventArgs^
 e )
{
    if ( cellErrorLocation != nullptr )
    {
        if ( e->ColumnIndex == cellErrorLocation->ColumnIndex
 && e->RowIndex == cellErrorLocation->RowIndex )
        {
            e->ErrorText = cellErrorText;
        }
    }
}

DataTable^ Populate( String^ query, bool resetUnsharedCounter
 )
{
    if ( resetUnsharedCounter )
    {
        ResetCounter();
    }


    // Alter the data source as necessary
    SqlDataAdapter^ adapter = gcnew SqlDataAdapter( query,
        gcnew SqlConnection( L"Integrated Security=SSPI;Persist Security Info=False;"
        L"Initial Catalog=Northwind;Data Source= localhost" ) );
    DataTable^ table = gcnew DataTable;
    adapter->Fill( table );
    return table;
}

Label^ count;
int unsharedRowCounter;
void ResetCounter()
{
    unsharedRowCounter = 0;
    count->Text = unsharedRowCounter.ToString();
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
ContextMenuStrip クラス
DataGridView.DataSource プロパティ
DataGridView.VirtualMode プロパティ
DataGridViewCellContextMenuStripNeededEventHandler
DataGridViewCellContextMenuStripNeededEventArgs
DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip
DataGridViewCell.ContextMenuStrip
OnCellContextMenuStripNeeded
その他の技術情報
DataGridView コントロール (Windows フォーム)

このページでは「.NET Framework クラスライブラリリファレンス」からDataGridView.CellContextMenuStripNeeded イベントを検索した結果を表示しています。
Weblioに収録されているすべての辞書からDataGridView.CellContextMenuStripNeeded イベントを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からDataGridView.CellContextMenuStripNeeded イベントを検索

>> 「DataGridView.CellContextMenuStripNeeded イベント」を含む用語の索引
DataGridView.CellContextMenuStripNeeded イベントのページへのリンク

DataGridView.CellContextMenuStripNeeded イベントとは？わかりやすく解説

DataGridView.CellContextMenuStripNeeded イベント

「DataGridView.CellContextMenuStripNeeded イベント」の関連用語


	© 2025 Microsoft.All rights reserved.

DataGridView.CellContextMenuStripNeeded イベントとは？ わかりやすく解説

DataGridView.CellContextMenuStripNeeded イベント

急上昇のことば

「DataGridView.CellContextMenuStripNeeded イベント」の関連用語

DataGridView.CellContextMenuStripNeeded イベントとは？わかりやすく解説