ContextMenu Classe

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: ContextMenu.cs

Source:: ContextMenu.cs

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.

Attention

ContextMenu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ContextMenuStrip instead.

Représente un menu contextuel.

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez ContextMenuStrip à la place, qui remplace et étend le ContextMenu contrôle.

public ref class ContextMenu : System::Windows::Forms::Menu

public class ContextMenu : System.Windows.Forms.Menu

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class ContextMenu : System.Windows.Forms.Menu

type ContextMenu = class
    inherit Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ContextMenu = class
    inherit Menu

Public Class ContextMenu
Inherits Menu

Héritage: Object

MarshalByRefObject

Component

Menu
ContextMenu

Attributs: BrowsableAttribute ObsoleteAttribute

Exemples

L’exemple de code suivant crée un gestionnaire d’événements pour l’événement Popup du ContextMenu. Le code du gestionnaire d’événements détermine lequel de deux contrôles est PictureBox nommé pictureBox1 et nommé TextBoxtextBox1 est le contrôle affichant le menu contextuel. Selon le contrôle à l’origine de l’affichage ContextMenu de son menu contextuel, le contrôle ajoute les objets appropriés MenuItem à l’objet ContextMenu. Cet exemple nécessite que vous ayez une instance de la ContextMenu classe, nommée contextMenu1, définie dans le formulaire. Cet exemple nécessite également que vous ayez un TextBox formulaire et PictureBox que la ContextMenu propriété de ces contrôles soit définie contextMenu1sur .

private:
   void MyPopupEventHandler( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Define the MenuItem objects to display for the TextBox.
      MenuItem^ menuItem1 = gcnew MenuItem( "&Copy" );
      MenuItem^ menuItem2 = gcnew MenuItem( "&Find and Replace" );
      // Define the MenuItem object to display for the PictureBox.
      MenuItem^ menuItem3 = gcnew MenuItem( "C&hange Picture" );
      
      // Clear all previously added MenuItems.
      contextMenu1->MenuItems->Clear();

      if ( contextMenu1->SourceControl == textBox1 )
      {
         
         // Add MenuItems to display for the TextBox.
         contextMenu1->MenuItems->Add( menuItem1 );
         contextMenu1->MenuItems->Add( menuItem2 );
      }
      else if ( contextMenu1->SourceControl == pictureBox1 )
      {
         // Add the MenuItem to display for the PictureBox.
         contextMenu1->MenuItems->Add( menuItem3 );
      }
   }

private void MyPopupEventHandler(System.Object sender, System.EventArgs e)
 {
    // Define the MenuItem objects to display for the TextBox.
    MenuItem menuItem1 = new MenuItem("&Copy");
    MenuItem menuItem2 = new MenuItem("&Find and Replace");
    // Define the MenuItem object to display for the PictureBox.
    MenuItem menuItem3 = new MenuItem("C&hange Picture");

    // Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear();
 
    if(contextMenu1.SourceControl == textBox1)
    {
       // Add MenuItems to display for the TextBox.
       contextMenu1.MenuItems.Add(menuItem1);
       contextMenu1.MenuItems.Add(menuItem2);
    }
    else if(contextMenu1.SourceControl == pictureBox1)
    {
       // Add the MenuItem to display for the PictureBox.
       contextMenu1.MenuItems.Add(menuItem3);
    }
 }

Private Sub MyPopupEventHandler(sender As System.Object, e As System.EventArgs)
    ' Define the MenuItem objects to display for the TextBox.
    Dim menuItem1 As New MenuItem("&Copy")
    Dim menuItem2 As New MenuItem("&Find and Replace")
    ' Define the MenuItem object to display for the PictureBox.
    Dim menuItem3 As New MenuItem("C&hange Picture")
    
    ' Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear()
    
    If contextMenu1.SourceControl Is textBox1 Then
        ' Add MenuItems to display for the TextBox.
        contextMenu1.MenuItems.Add(menuItem1)
        contextMenu1.MenuItems.Add(menuItem2)
    ElseIf contextMenu1.SourceControl Is pictureBox1 Then
        ' Add the MenuItem to display for the PictureBox.
        contextMenu1.MenuItems.Add(menuItem3)
    End If
End Sub

Remarques

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez ContextMenuStrip à la place.

La ContextMenu classe représente des menus contextuels qui peuvent être affichés lorsque l’utilisateur clique sur le bouton droit de la souris sur un contrôle ou une zone du formulaire. Les menus contextuels sont généralement utilisés pour combiner différents éléments de menu d’un MainMenu formulaire qui sont utiles pour l’utilisateur en fonction du contexte de l’application. Par exemple, vous pouvez utiliser un menu contextuel affecté à un TextBox contrôle pour fournir des éléments de menu pour modifier la police du texte, rechercher du texte dans le contrôle ou des fonctionnalités du Presse-papiers pour copier et coller du texte. Vous pouvez également afficher de nouveaux MenuItem objets dans un menu contextuel qui ne se trouvent pas dans un MainMenu pour fournir des commandes spécifiques à la situation qui ne sont pas appropriées pour l’affichage MainMenu .

En règle générale, un menu contextuel s’affiche lorsqu’un utilisateur clique sur le bouton droit de la souris sur un contrôle ou le formulaire lui-même. Les contrôles visibles et Form ont une ContextMenu propriété qui lie la ContextMenu classe au contrôle qui affiche le menu contextuel. Plusieurs contrôles peuvent utiliser un ContextMenu. Vous pouvez utiliser la SourceControl propriété pour déterminer quel contrôle a affiché le dernier affichage du menu contextuel afin d’effectuer des tâches spécifiques au contrôle ou de modifier le menu contextuel affiché pour le contrôle.

Vous souhaiterez peut-être savoir quand le menu contextuel s’affiche pour définir des coches, désactiver des éléments et effectuer d’autres tâches de menu avant que le menu ne soit affiché à l’utilisateur. Vous pouvez gérer l’événement Popup pour déterminer quand le menu contextuel est affiché.

Note

Pour réutiliser MenuItem les objets affichés dans un MainMenu objet à utiliser dans un ContextMenu, vous devez créer une copie du menu à l’aide de la CloneMenu méthode de la MenuItem classe. Vous pouvez également fusionner les éléments de menu et leurs sous-menus en un seul MenuItem objet à l’aide de la MergeMenu méthode de la MenuItem classe.

Constructeurs

Nom	Description
ContextMenu()	Obsolète. Initialise une nouvelle instance de la ContextMenu classe sans éléments de menu spécifiés.
ContextMenu(MenuItem[])	Obsolète. Initialise une nouvelle instance de la ContextMenu classe avec un ensemble d’objets MenuItem spécifié.

Champs

Nom	Description
FindHandle	Obsolète. Spécifie que la FindMenuItem(Int32, IntPtr) méthode doit rechercher un handle. (Hérité de Menu)
FindShortcut	Obsolète. Spécifie que la FindMenuItem(Int32, IntPtr) méthode doit rechercher un raccourci. (Hérité de Menu)

Propriétés

Nom	Description
CanRaiseEvents	Obsolète. Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
Container	Obsolète. Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
DesignMode	Obsolète. Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obsolète. Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component)
Handle	Obsolète. Obtient une valeur représentant le handle de fenêtre du menu. (Hérité de Menu)
IsParent	Obsolète. Obtient une valeur indiquant si ce menu contient des éléments de menu. Cette propriété est en lecture seule. (Hérité de Menu)
MdiListItem	Obsolète. Obtient une valeur indiquant celle MenuItem utilisée pour afficher une liste de formulaires enfants multi-interface de document (MDI). (Hérité de Menu)
MenuItems	Obsolète. Obtient une valeur indiquant la collection d’objets MenuItem associés au menu. (Hérité de Menu)
Name	Obsolète. Obtient ou définit le nom du Menu. (Hérité de Menu)
RightToLeft	Obsolète. Obtient ou définit une valeur indiquant si le texte affiché par le contrôle est affiché de droite à gauche.
Site	Obsolète. Obtient ou définit le ISite Component. (Hérité de Component)
SourceControl	Obsolète. Obtient le contrôle qui affiche le menu contextuel.
Tag	Obsolète. Obtient ou définit les données définies par l’utilisateur associées au contrôle. (Hérité de Menu)

Méthodes

Nom	Description
CloneMenu(Menu)	Obsolète. Copie l’objet Menu passé en tant que paramètre à l’état actuel Menu. (Hérité de Menu)
CreateMenuHandle()	Obsolète. Crée un handle pour le Menu. (Hérité de Menu)
CreateObjRef(Type)	Obsolète. Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Obsolète. Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Obsolète. Supprime les ressources, autres que la mémoire, utilisées par le Menu. (Hérité de Menu)
Equals(Object)	Obsolète. Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindMenuItem(Int32, IntPtr)	Obsolète. Obtient la MenuItem valeur spécifiée. (Hérité de Menu)
FindMergePosition(Int32)	Obsolète. Retourne la position à laquelle un élément de menu doit être inséré dans le menu. (Hérité de Menu)
GetContextMenu()	Obsolète. Obtient le ContextMenu menu qui contient ce menu. (Hérité de Menu)
GetHashCode()	Obsolète. Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMainMenu()	Obsolète. Obtient le MainMenu menu qui contient ce menu. (Hérité de Menu)
GetService(Type)	Obsolète. Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obsolète. Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Obsolète. Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Obsolète. Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
MergeMenu(Menu)	Obsolète. Fusionne les MenuItem objets d’un menu avec le menu actif. (Hérité de Menu)
OnCollapse(EventArgs)	Obsolète. Déclenche l’événement Collapse.
OnPopup(EventArgs)	Obsolète. Déclenche l’événement Popup.
ProcessCmdKey(Message, Keys, Control)	Obsolète. Traite une clé de commande.
ProcessCmdKey(Message, Keys)	Obsolète. Traite une clé de commande. (Hérité de Menu)
Show(Control, Point, LeftRightAlignment)	Obsolète. Affiche le menu contextuel à la position spécifiée et avec l’alignement spécifié.
Show(Control, Point)	Obsolète. Affiche le menu contextuel à la position spécifiée.
ToString()	Obsolète. Retourne un String qui représente le Menu contrôle. (Hérité de Menu)

Événements

Nom	Description
Collapse	Obsolète. Se produit lorsque le menu contextuel est réduit.
Disposed	Obsolète. Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)
Popup	Obsolète. Se produit avant l’affichage du menu contextuel.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?