DataGridViewCellContextMenuStripNeededEventHandler Delegat

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewEventHandlers.cs

Stellt die Methode dar, die ein CellContextMenuStripNeeded-Ereignis einer DataGridView behandelt.

C#

public delegate void DataGridViewCellContextMenuStripNeededEventHandler(object? sender, DataGridViewCellContextMenuStripNeededEventArgs e);

Parameter

sender

Object

Die Quelle des Ereignisses.

e

DataGridViewCellContextMenuStripNeededEventArgs

Ein DataGridViewCellContextMenuStripNeededEventArgs, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird verwendet DataGridViewCellContextMenuStripNeededEventArgs , um das Kontextmenü festzulegen, ohne die Freigabe der Zeile aufzuheben.

C#

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

Hinweise

Das CellContextMenuStripNeeded Ereignis tritt nur auf, wenn die DataGridView Steuerelementeigenschaft DataSource festgelegt oder die VirtualMode -Eigenschaft ist true.

Wenn Sie das CellContextMenuStripNeeded Ereignis behandeln, wird das Kontextmenü angezeigt, das Sie im Handler angeben, wenn der Benutzer mit der rechten Maustaste auf eine Zelle klickt. Dies ist nützlich, wenn Sie Kontextmenüs anzeigen möchten, die vom aktuellen Zustand oder Wert einer Zelle bestimmt werden.

Das CellContextMenuStripNeeded Ereignis tritt auch auf, wenn der Wert der DataGridViewCell.ContextMenuStrip Eigenschaft abgerufen wird, entweder programmgesteuert oder wenn der Benutzer mit der rechten Maustaste auf die Zelle klickt.

Sie können die ColumnIndex Eigenschaften und RowIndex verwenden, um den Zustand oder Wert einer Zelle zu bestimmen, und diese Informationen verwenden, um die ContextMenuStrip Eigenschaft festzulegen. Diese Eigenschaft wird mit dem Wert der Zelleigenschaft ContextMenuStrip initialisiert, die vom Ereigniswert außer Kraft gesetzt wird.

Behandeln Sie das CellContextMenuStripNeeded Ereignis, wenn Sie mit großen Datenmengen arbeiten, um Leistungseinbußen beim Festlegen des Zellwerts ContextMenuStrip für mehrere Zellen zu vermeiden. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

Sie können auch Kontextmenüs für einzelne Zeilen anstelle einzelner Zellen angeben, indem Sie die Zeileneigenschaft ContextMenuStrip festlegen oder das Ereignis des DataGridView Steuerelements RowContextMenuStripNeeded behandeln. Die Zelleigenschaftseinstellung ContextMenuStrip überschreibt die Zeileneigenschaftseinstellung ContextMenuStrip , und das CellContextMenuStripNeeded Ereignis überschreibt sowohl das RowContextMenuStripNeeded Ereignis als auch die Zeileneigenschaftseinstellung ContextMenuStrip . Sie können jedoch für ein Zellverknüpfungsmenü angeben null , um zu verhindern, dass ein Zeilenverknüpfungsmenü überschrieben wird.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Beim Erstellen eines DataGridViewCellContextMenuStripNeededEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen zu Ereignishandlerdelegierten finden Sie unter Behandeln und Auslösen von Ereignissen.

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• DataGridView
• CellContextMenuStripNeeded
• DataSource
• VirtualMode
• DataGridViewCellContextMenuStripNeededEventArgs
• ContextMenuStrip
• ContextMenuStrip
• RowContextMenuStripNeeded
• ContextMenuStrip
• ContextMenuStrip
• Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms