DataGridViewRow.ContextMenuStrip Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Přidružená ContextMenuStrip k aktuálnímu DataGridViewRow. Výchozí formát je null
.
Výjimky
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 .