Edit

Share via


DataGridViewCell.GetInheritedContextMenuStrip(Int32) Method

Definition

Gets the inherited shortcut menu for the current cell.

public:
 virtual System::Windows::Forms::ContextMenuStrip ^ GetInheritedContextMenuStrip(int rowIndex);
public virtual System.Windows.Forms.ContextMenuStrip GetInheritedContextMenuStrip (int rowIndex);
public virtual System.Windows.Forms.ContextMenuStrip? GetInheritedContextMenuStrip (int rowIndex);
abstract member GetInheritedContextMenuStrip : int -> System.Windows.Forms.ContextMenuStrip
override this.GetInheritedContextMenuStrip : int -> System.Windows.Forms.ContextMenuStrip
Public Overridable Function GetInheritedContextMenuStrip (rowIndex As Integer) As ContextMenuStrip

Parameters

rowIndex
Int32

The row index of the current cell.

Returns

A ContextMenuStrip if the parent DataGridView, DataGridViewRow, or DataGridViewColumn has a ContextMenuStrip assigned; otherwise, null.

Exceptions

The value of the DataGridView property of the cell is not null and the specified rowIndex is less than 0 or greater than the number of rows in the control minus 1.

ColumnIndex is less than 0, indicating that the cell is a row header cell.

Remarks

If the cell does not have an associated ContextMenuStrip, it will inherit one from its parents, using the following precedence:

  1. This cell's ContextMenuStrip

  2. The owning row's DataGridViewRow.ContextMenuStrip

  3. The owning column's DataGridViewColumn.ContextMenuStrip

  4. The parent table's System.Windows.Forms.ContextMenuStrip

Shortcut menus are Microsoft Windows native resources whose lifetimes are typically directed by the Dispose method or the destructor.

Pass the GetInheritedContextMenuStrip method the row index you used to retrieve the DataGridViewCell. Do not use the RowIndex property for the rowIndex parameter. If the row is shared, RowIndex is -1, which is not a valid value for rowIndex.

Applies to

See also