DataGridViewCell.ContextMenuStrip Propriété

Définition

Obtient ou définit le menu contextuel associé à la cellule.

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; }
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 associé à la cellule.

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.

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

La gestion de l’événement CellContextMenuStripNeeded est principalement utile lors de l’utilisation de grandes quantités de données afin d’éviter des pénalités de performances lors de la définition de la valeur de cellule ContextMenuStrip pour plusieurs cellules. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

La modification de cette propriété déclenche l’événement CellContextMenuStripChanged sur le propriétaire DataGridView, le cas échéant.

Vous pouvez également spécifier des menus contextuels pour des lignes individuelles plutôt que des cellules individuelles en définissant la propriété de ligne ContextMenuStrip ou en gérant l’événement DataGridView du RowContextMenuStripNeeded contrôle. Le paramètre de propriété de cellule ContextMenuStrip remplace le paramètre de propriété de ligne ContextMenuStrip , et l’événement CellContextMenuStripNeeded remplace à la fois l’événement RowContextMenuStripNeeded et le paramètre de propriété de ligne ContextMenuStrip . Vous pouvez toutefois spécifier null un menu contextuel de cellule pour empêcher le remplacement d’un menu contextuel de ligne.

S’applique à

Voir aussi