DataGridViewCell.ContextMenuStrip Eigenschaft

Definition

Ruft das der Zelle zugeordnete Kontextmenü ab oder legt dieses fest.Gets or sets the shortcut menu associated with the cell.

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

Eigenschaftswert

Der der Zelle zugeordnete ContextMenuStrip.The ContextMenuStrip associated with the cell.

Hinweise

Diese Eigenschaft gibt das Kontextmenü an, das normalerweise angezeigt wird, wenn der Benutzer mit der rechten Maustaste auf die Zelle klickt.This property indicates the shortcut menu that is typically displayed when the user right-clicks the cell.

Wenn die DataGridView-Steuerelement DataSource-Eigenschaft festgelegt ist oder deren VirtualMode-Eigenschaft trueist, wird durch das erhalten des Werts der ContextMenuStrip-Eigenschaft das CellContextMenuStripNeeded-Ereignis des Steuer Elements ausgelöst und der Wert der DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip-Eigenschaft wie im Ereignis angegeben zurückgegeben. lers.When the DataGridView control DataSource property is set or its VirtualMode property is true, getting the value of the ContextMenuStrip property raises the CellContextMenuStripNeeded event of the control and returns the value of the DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip property as specified in the event handler. Wenn keine Handler für das-Ereignis vorhanden sind, gibt der Wert der ContextMenuStrip-Eigenschaft den zuvor angegebenen Wert oder den Standardwert nullzurück.If there are no handlers for the event, getting the value of the ContextMenuStrip property returns the previously specified value or its default value of null.

Die Behandlung des CellContextMenuStripNeeded Ereignisses ist vor allem nützlich, wenn Sie mit großen Datenmengen arbeiten, um beim Festlegen der Zelle ContextMenuStrip Werts für mehrere Zellen Leistungseinbußen zu vermeiden.Handling the CellContextMenuStripNeeded event is primarily useful when working with large amounts of data to avoid performance penalties when setting the cell ContextMenuStrip value for multiple cells. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Wenn Sie diese Eigenschaft ändern, wird das CellContextMenuStripChanged-Ereignis auf dem besitzenden DataGridViewausgelöst, sofern vorhanden.Changing this property raises the CellContextMenuStripChanged event on the owning DataGridView, if one exists.

Sie können auch Kontextmenüs für einzelne Zeilen anstelle einzelner Zellen angeben, indem Sie die Zeile ContextMenuStrip-Eigenschaft festlegen oder das RowContextMenuStripNeeded Ereignis des DataGridView Steuer Elements behandeln.You can also specify shortcut menus for individual rows rather than individual cells by setting the row ContextMenuStrip property or handling the DataGridView control's RowContextMenuStripNeeded event. Die Eigenschaft "Cell ContextMenuStrip" überschreibt die Eigenschaft "ContextMenuStrip" der Eigenschaft, und das Ereignis "CellContextMenuStripNeeded" überschreibt sowohl das RowContextMenuStripNeeded-Ereignis als auch die Eigenschaft "ContextMenuStrip" für Zeilen.The cell ContextMenuStrip property setting overrides the row ContextMenuStrip property setting, and the CellContextMenuStripNeeded event overrides both the RowContextMenuStripNeeded event and the row ContextMenuStrip property setting. Sie können jedoch null für das Kontextmenü einer Zelle angeben, um zu verhindern, dass ein Zeilen Kontextmenü überschrieben wird.You can specify null for a cell shortcut menu, however, to prevent a row shortcut menu from being overridden.

Gilt für:

Siehe auch