Partager via


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é

Associé ContextMenuStrip à la cellule.

Remarques

Cette propriété indique le menu contextuel qui est généralement affiché lorsque l’utilisateur clique avec le bouton droit sur la cellule.

Lorsque la DataGridView propriété de contrôle DataSource est définie ou sa VirtualMode propriété 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 nullpar défaut .

La gestion de l’événement CellContextMenuStripNeeded est principalement utile lors de l’utilisation de grandes quantités de données pour éviter les pénalités de performances lors de la définition de la valeur de cellule ContextMenuStrip pour plusieurs cellules. Pour plus d’informations, consultez Les 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, s’il en existe un.

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 . Toutefois, vous pouvez spécifier null un menu contextuel de cellule pour empêcher la substitution d’un menu contextuel de ligne.

S’applique à

Voir aussi