DataGridViewRowContextMenuStripNeededEventHandler Delegato

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewEventHandlers.cs

Rappresenta il metodo che gestirà l'evento RowContextMenuStripNeeded di un oggetto DataGridView.

public delegate void DataGridViewRowContextMenuStripNeededEventHandler(System::Object ^ sender, DataGridViewRowContextMenuStripNeededEventArgs ^ e);

public delegate void DataGridViewRowContextMenuStripNeededEventHandler(object? sender, DataGridViewRowContextMenuStripNeededEventArgs e);

type DataGridViewRowContextMenuStripNeededEventHandler = delegate of obj * DataGridViewRowContextMenuStripNeededEventArgs -> unit

Public Delegate Sub DataGridViewRowContextMenuStripNeededEventHandler(sender As Object, e As DataGridViewRowContextMenuStripNeededEventArgs)

Parametri

sender

Object

Origine dell'evento.

e

DataGridViewRowContextMenuStripNeededEventArgs

Oggetto DataGridViewRowContextMenuStripNeededEventArgs che contiene i dati dell'evento.

Esempio

Nell'esempio di codice seguente l'evento RowContextMenuStripNeeded viene gestito per fornire un ContextMenuStrip oggetto in base al titolo del dipendente. In questo esempio, due sono disponibili due menu di scelta rapida, uno per i responsabili e uno per tutti gli altri dipendenti.

void dataGridView1_RowContextMenuStripNeeded(object sender,
    DataGridViewRowContextMenuStripNeededEventArgs e)
{
    DataGridViewRow dataGridViewRow1 = dataGridView1.Rows[e.RowIndex];

    toolStripMenuItem1.Enabled = true;

    // Show the appropriate ContextMenuStrip based on the employees title.
    if ((dataGridViewRow1.Cells["Title"].Value.ToString() ==
        "Sales Manager") ||
        (dataGridViewRow1.Cells["Title"].Value.ToString() ==
        "Vice President, Sales"))
    {
        e.ContextMenuStrip = managerMenuStrip;
    }
    else
    {
        e.ContextMenuStrip = employeeMenuStrip;
    }

    contextMenuRowIndex = e.RowIndex;
}

Public Sub dataGridView1_RowContextMenuStripNeeded( _
    ByVal sender As Object, _
    ByVal e As DataGridViewRowContextMenuStripNeededEventArgs) _
    Handles dataGridView1.RowContextMenuStripNeeded

    Dim dataGridViewRow1 As DataGridViewRow = _
    dataGridView1.Rows(e.RowIndex)

    toolStripMenuItem1.Enabled = True

    ' Show the appropriate ContextMenuStrip based on the employees title.
    If dataGridViewRow1.Cells("Title").Value.ToString() = _
        "Sales Manager" OrElse _
        dataGridViewRow1.Cells("Title").Value.ToString() = _
        "Vice President, Sales" Then

        e.ContextMenuStrip = managerMenuStrip
    Else
        e.ContextMenuStrip = employeeMenuStrip
    End If

    contextMenuRowIndex = e.RowIndex
End Sub

Commenti

L'evento RowContextMenuStripNeeded si verifica solo quando la proprietà del controllo DataSource è impostata o la DataGridView relativa VirtualMode proprietà è true. RowContextMenuStripNeeded La gestione dell'evento è utile quando si vuole visualizzare un menu di scelta rapida determinato dallo stato corrente di una riga o dai valori contenuti.

Quando si gestisce l'evento RowContextMenuStripNeeded , viene visualizzato il menu di scelta rapida specificato nel gestore ogni volta che l'utente fa clic con il pulsante destro del mouse su una riga, a meno CellContextMenuStripNeeded che non venga eseguito l'override del menu di scelta rapida per la cella specifica selezionata.

L'evento RowContextMenuStripNeeded si verifica anche ogni volta che viene recuperato il valore della proprietà, a livello di codice o quando l'utente fa clic con il pulsante destro del DataGridViewRow.ContextMenuStrip mouse su una riga.

È possibile usare la DataGridViewRowContextMenuStripNeededEventArgs.RowIndex proprietà per determinare lo stato di una riga o i valori contenuti e usare queste informazioni per modificare o modificare la DataGridViewRowContextMenuStripNeededEventArgs.ContextMenuStrip proprietà. Questa proprietà viene inizializzata con il valore della proprietà di riga ContextMenuStrip , che il valore dell'evento esegue l'override.

Gestire l'evento quando si usano grandi quantità di dati per evitare le penali per le prestazioni dell'impostazione RowContextMenuStripNeeded del valore della riga ContextMenuStrip per più righe. Per altre informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Quando si crea un delegato DataGridViewRowContextMenuStripNeededEventHandler, si identifica il metodo che gestirà l'evento. Per associare l'evento al gestore eventi in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non venga rimosso il delegato. Per altre informazioni sui delegati del gestore eventi, vedere Gestione e generazione di eventi.

Metodi di estensione

Vedi anche

• ContextMenuStrip
• DataGridView
• RowContextMenuStripNeeded
• DataSource
• VirtualMode
• DataGridViewRowContextMenuStripNeededEventArgs
• ContextMenuStrip
• ContextMenuStrip
• Procedure consigliate per ridimensionare il controllo DataGridView Windows Form