DataGridViewCell.ContextMenuStrip Propriété

Définition

Obtient ou définit le menu contextuel associé à la cellule.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

Valeur de propriété

ContextMenuStrip

ContextMenuStrip associé à la cellule.The ContextMenuStrip associated with the cell.

Remarques

Cette propriété indique le menu contextuel qui s’affiche généralement lorsque l’utilisateur clique avec le bouton droit sur la cellule.This property indicates the shortcut menu that is typically displayed when the user right-clicks the cell.

Lorsque la propriété de DataSource de contrôle DataGridView est définie ou que sa propriété VirtualMode est true, l’obtention de la valeur de la propriété ContextMenuStrip déclenche l’événement CellContextMenuStripNeeded du contrôle et retourne la valeur de la propriété DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip comme spécifié dans le gestionnaire d’événements.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. S’il n’existe aucun gestionnaire pour l’événement, l’obtention de la valeur de la propriété ContextMenuStrip retourne la valeur précédemment spécifiée ou sa valeur par défaut de null.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.

La gestion de l’événement CellContextMenuStripNeeded est surtout utile lorsque vous travaillez avec de grandes quantités de données afin d’éviter des pénalités en matière de performances lors de la définition de la valeur de ContextMenuStrip de cellule pour plusieurs cellules.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. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

La modification de cette propriété déclenche l’événement CellContextMenuStripChanged sur le DataGridViewpropriétaire, s’il en existe un.Changing this property raises the CellContextMenuStripChanged event on the owning DataGridView, if one exists.

Vous pouvez également spécifier des menus contextuels pour des lignes individuelles plutôt que des cellules individuelles en définissant la propriété Row ContextMenuStrip ou en gérant l’événement RowContextMenuStripNeeded du contrôle DataGridView.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. Le paramètre de la propriété ContextMenuStrip de la cellule remplace le paramètre de la propriété Row ContextMenuStrip et l’événement CellContextMenuStripNeeded remplace à la fois l’événement RowContextMenuStripNeeded et le paramètre de propriété ContextMenuStrip Row.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. Vous pouvez toutefois spécifier null pour un menu contextuel de cellule pour empêcher le remplacement d’un menu contextuel de ligne.You can specify null for a cell shortcut menu, however, to prevent a row shortcut menu from being overridden.

S’applique à

Voir aussi