DataGridViewRow.ContextMenuStrip Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví místní nabídku pro řádek.

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

Hodnota vlastnosti

ContextMenuStrip

Přidružená ContextMenuStrip k aktuálnímu DataGridViewRow. Výchozí formát je null.

Výjimky

InvalidOperationException

Při získání hodnoty této vlastnosti je řádek v ovládacím DataGridView prvku a je sdíleným řádkem.

Příklady

Následující příklad kódu ukazuje, jak použít DataGridViewColumn.ContextMenuStrip vlastnost, která je téměř shodná s ContextMenuStrip vlastností DataGridViewRow třídy . Tento příklad kódu je součástí většího příkladu DataGridViewColumn kódu, který je k dispozici ve třídě .

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

Poznámky

Tato vlastnost označuje místní nabídku, která se zobrazí, když uživatel klikne pravým tlačítkem myši na řádek, pokud DataGridView událost ovládacího prvku CellContextMenuStripNeeded nebo vlastnost řádku ContextMenuStrip nepřepíše místní nabídku pro konkrétní buňku, na kterou jste klikli.

DataGridView Pokud je vlastnost ovládacího prvku DataSource nastavena nebo je její VirtualMode vlastnost je true, získání hodnoty ContextMenuStrip vlastnosti vyvolá RowContextMenuStripNeeded událost ovládacího prvku a vrátí hodnotu DataGridViewRowContextMenuStripNeededEventArgs.ContextMenuStrip vlastnosti, jak je zadána v obslužné rutině události. Pokud pro událost neexistují žádné obslužné rutiny, načtení hodnoty ContextMenuStrip vlastnosti vrátí dříve zadanou hodnotu nebo výchozí hodnotu null.

RowContextMenuStripNeeded Zpracování události je primárně užitečné při práci s velkými objemy dat, aby se při nastavování hodnoty řádku ContextMenuStrip pro více řádků zabránilo snížení výkonu. Další informace najdete v tématu Osvědčené postupy pro škálování ovládacího prvku model Windows Forms DataGridView.

Změna této vlastnosti vyvolá RowContextMenuStripChanged událost u vlastnícího DataGridViewobjektu , pokud existuje.

Pokud je aktuální řádek sdílen, místo získání hodnoty této vlastnosti použijte GetContextMenuStrip metodu .

Platí pro

Viz také