DataGridViewCell.GetInheritedContextMenuStrip(Int32) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

ContextMenuStrip

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

Exceptions

ArgumentOutOfRangeException

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.

InvalidOperationException

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:

This cell's ContextMenuStrip
The owning row's DataGridViewRow.ContextMenuStrip
The owning column's DataGridViewColumn.ContextMenuStrip
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