Evento DataGridView.RowContextMenuStripNeeded

The RowContextMenuStripNeeded evento ocorre somente quando o DataGridView controle DataSource propriedade é definida ou seu VirtualMode propriedade é true. Manipulando o RowContextMenuStripNeeded evento é útil quando você deseja exibir um menu de atalho determinado pelo estado corrente da linha ou os valores que ele contém.

Quando você manipula o RowContextMenuStripNeeded evento, no menu de atalho que você especificar o manipulador é mostrado sempre que o usuário clica com o botão direito do mouse uma linha, a menos que o CellContextMenuStripNeeded substitui o menu de atalho para essa célula específica que foi clicado.

The RowContextMenuStripNeeded evento também ocorre sempre que o valor da DataGridViewRow.ContextMenuStrip propriedade é recuperada, seja por meio de programação ou quando o usuário clica com o botão direito do mouse uma linha.

Você pode usar o DataGridViewRowContextMenuStripNeededEventArgs.RowIndex propriedade para determinar o estado de uma linha ou valores que ele contém e usar essas informações para alterar ou modificar o DataGridViewRowContextMenuStripNeededEventArgs.ContextMenuStrip propriedade. Esta propriedade é inicializada com o valor do linha ContextMenuStrip propriedade, que substitui o valor do evento.

Manipular o RowContextMenuStripNeeded evento ao trabalhar com grandes quantidades de dados para evitar penalidades de desempenho da configuração da linha ContextMenuStrip valor de várias linhas. Para obter mais informações, consulte Práticas recomendadas para escala o controle DataGridView do Windows Forms.

Para obter mais informações sobre tratamento eventos, consulte Consumindo Eventos.

O exemplo de código a seguir manipula o RowContextMenuStripNeeded evento para fornecer um ContextMenuStrip com base no título do funcionário. Neste exemplo, há menus de atalho dois, para os gerentes e para todos os outros funcionários.

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

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

.NET Framework

Referência

Outros recursos