DataGridViewCell.ContextMenuStrip Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.