Partilhar via


DataGridViewRow.ContextMenuStrip Propriedade

Definição

Obtém ou define o menu de atalho da linha.

public:
 virtual property System::Windows::Forms::ContextMenuStrip ^ ContextMenuStrip { System::Windows::Forms::ContextMenuStrip ^ get(); void set(System::Windows::Forms::ContextMenuStrip ^ value); };
public override System.Windows.Forms.ContextMenuStrip ContextMenuStrip { get; set; }
public override System.Windows.Forms.ContextMenuStrip? ContextMenuStrip { get; set; }
member this.ContextMenuStrip : System.Windows.Forms.ContextMenuStrip with get, set
Public Overrides Property ContextMenuStrip As ContextMenuStrip

Valor da propriedade

O ContextMenuStrip associado ao DataGridViewRow atual. O padrão é null.

Exceções

Ao obter o valor dessa propriedade, a linha está em um controle DataGridView e é uma linha compartilhada.

Exemplos

O exemplo de código a seguir demonstra como usar a DataGridViewColumn.ContextMenuStrip propriedade , que é quase idêntica à ContextMenuStrip propriedade da DataGridViewRow classe . Este exemplo de código faz parte de um exemplo de código maior fornecido na DataGridViewColumn classe .

ToolStripMenuItem^ toolStripItem1;
void AddContextMenu()
{
   toolStripItem1->Text = L"Redden";
   toolStripItem1->Click += gcnew EventHandler( this, &DataGridViewColumnDemo::toolStripItem1_Click );
   System::Windows::Forms::ContextMenuStrip^ strip = gcnew System::Windows::Forms::ContextMenuStrip;
   IEnumerator^ myEnum = dataGridView->Columns->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewColumn^ column = safe_cast<DataGridViewColumn^>(myEnum->Current);
      column->ContextMenuStrip = strip;
      column->ContextMenuStrip->Items->Add( toolStripItem1 );
   }
}

DataGridViewCellEventArgs^ mouseLocation;

// Change the cell's color.
void toolStripItem1_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   dataGridView->Rows[ mouseLocation->RowIndex ]->Cells[ mouseLocation->ColumnIndex ]->Style->BackColor = Color::Red;
}


// Deal with hovering over a cell.
void dataGridView_CellMouseEnter( Object^ /*sender*/, DataGridViewCellEventArgs^ location )
{
   mouseLocation = location;
}
ToolStripMenuItem toolStripItem1 = new ToolStripMenuItem();

private void AddContextMenu()
{
    toolStripItem1.Text = "Redden";
    toolStripItem1.Click += new EventHandler(toolStripItem1_Click);
    ContextMenuStrip strip = new ContextMenuStrip();
    foreach (DataGridViewColumn column in dataGridView.Columns)
    {

        column.ContextMenuStrip = strip;
        column.ContextMenuStrip.Items.Add(toolStripItem1);
    }
}

private DataGridViewCellEventArgs mouseLocation;

// Change the cell's color.
private void toolStripItem1_Click(object sender, EventArgs args)
{
    dataGridView.Rows[mouseLocation.RowIndex]
        .Cells[mouseLocation.ColumnIndex].Style.BackColor
        = Color.Red;
}

// Deal with hovering over a cell.
private void dataGridView_CellMouseEnter(object sender,
    DataGridViewCellEventArgs location)
{
    mouseLocation = location;
}
WithEvents toolStripItem1 As New ToolStripMenuItem()

Private Sub AddContextMenu()
    toolStripItem1.Text = "Redden"
    Dim strip As New ContextMenuStrip()
    For Each column As DataGridViewColumn _
        In dataGridView.Columns()

        column.ContextMenuStrip = strip
        column.ContextMenuStrip.Items.Add(toolStripItem1)
    Next
End Sub
' Change the cell's color.
Private Sub toolStripItem1_Click(ByVal sender As Object, _
    ByVal args As EventArgs) _
    Handles toolStripItem1.Click

    dataGridView.Rows(mouseLocation.RowIndex) _
        .Cells(mouseLocation.ColumnIndex) _
        .Style.BackColor = Color.Red
End Sub

Private mouseLocation As DataGridViewCellEventArgs

' Deal with hovering over a cell.
Private Sub dataGridView_CellMouseEnter(ByVal sender As Object, _
    ByVal location As DataGridViewCellEventArgs) _
    Handles DataGridView.CellMouseEnter

    mouseLocation = location
End Sub

Comentários

Essa propriedade indica o menu de atalho exibido quando o usuário clica com o botão direito do mouse na linha, a menos que o DataGridView evento de controle CellContextMenuStripNeeded ou a propriedade de linha ContextMenuStrip substitua o menu de atalho da célula específica que foi clicada.

Quando a DataGridView propriedade de controle DataSource é definida ou sua VirtualMode propriedade é true, obter o valor da ContextMenuStrip propriedade gera o RowContextMenuStripNeeded evento do controle e retorna o valor da DataGridViewRowContextMenuStripNeededEventArgs.ContextMenuStrip propriedade conforme especificado no manipulador de eventos. Se não houver manipuladores para o evento, obter o valor da ContextMenuStrip propriedade retornará o valor especificado anteriormente ou seu valor padrão de null.

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

Alterar essa propriedade aciona o RowContextMenuStripChanged evento no proprietário DataGridView, se houver.

Se a linha atual for compartilhada, use o GetContextMenuStrip método em vez de obter o valor dessa propriedade.

Aplica-se a

Confira também