ContextMenu ContextMenu ContextMenu ContextMenu Class

Définition

Représente un menu contextuel.Represents a shortcut menu. Bien que ContextMenuStrip remplace et ajoute des fonctionnalités au contrôle ContextMenu des versions antérieures, ContextMenu est conservé pour la compatibilité descendante et l'utilisation future si tel est votre choix.Although ContextMenuStrip replaces and adds functionality to the ContextMenu control of previous versions, ContextMenu is retained for both backward compatibility and future use if you choose.

public ref class ContextMenu : System::Windows::Forms::Menu
public class ContextMenu : System.Windows.Forms.Menu
type ContextMenu = class
    inherit Menu
Public Class ContextMenu
Inherits Menu
Héritage

Exemples

L’exemple de code suivant crée un gestionnaire d’événements pour le Popup événements de la ContextMenu.The following code example creates an event handler for the Popup event of the ContextMenu. Le code dans le Gestionnaire d’événements détermine laquelle des deux contrôles un PictureBox nommé pictureBox1 et un TextBox nommé textBox1 est le contrôle affiche le menu contextuel.The code in the event handler determines which of two controls a PictureBox named pictureBox1 and a TextBox named textBox1 is the control displaying the shortcut menu. Selon le contrôle qui a provoqué la ContextMenu pour afficher son menu contextuel, le contrôle ajoute approprié MenuItem des objets sur le ContextMenu.Depending on which control caused the ContextMenu to display its shortcut menu, the control adds the appropriate MenuItem objects to the ContextMenu. Cet exemple nécessite que vous disposez d’une instance de la ContextMenu classe, nommée contextMenu1, défini dans le formulaire.This example requires that you have an instance of the ContextMenu class, named contextMenu1, defined within the form. Cet exemple nécessite également que vous avez un TextBox et PictureBox ajouté à un formulaire et que le ContextMenu propriété de ces contrôles est définie sur contextMenu1.This example also requires that you have a TextBox and PictureBox added to a form and that the ContextMenu property of these controls is set to contextMenu1.

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 'MyPopupEventHandler '

Remarques

Le ContextMenu classe représente des menus contextuels qui peuvent être affichées lorsque l’utilisateur clique sur le bouton droit de la souris sur un contrôle ou de la zone du formulaire.The ContextMenu class represents shortcut menus that can be displayed when the user clicks the right mouse button over a control or area of the form. Menus contextuels sont généralement utilisés pour combiner différents éléments de menu à partir d’un MainMenu d’un formulaire qui sont utiles pour l’utilisateur étant donné le contexte de l’application.Shortcut menus are typically used to combine different menu items from a MainMenu of a form that are useful for the user given the context of the application. Par exemple, vous pouvez utiliser un menu contextuel assigné à un TextBox contrôle afin de fournir des éléments de menu pour la modification de la police du texte, rechercher du texte dans le contrôle, ou les fonctionnalités du Presse-papiers pour copier et coller le texte.For example, you can use a shortcut menu assigned to a TextBox control to provide menu items for changing the font of the text, finding text within the control, or Clipboard features for copying and pasting text. Vous pouvez également afficher les nouveaux MenuItem dans un menu contextuel des objets qui ne sont pas situés dans un MainMenu pour fournir des commandes spécifiques qui ne sont pas appropriées pour le MainMenu à afficher.You can also display new MenuItem objects in a shortcut menu that are not located within a MainMenu to provide situation specific commands that are not appropriate for the MainMenu to display.

En règle générale, un menu contextuel s’affiche quand un utilisateur clique sur le bouton droit de la souris sur un contrôle ou le formulaire lui-même.Typically, a shortcut menu is displayed when a user clicks the right mouse button over a control or the form itself. Les contrôles visibles et Form ont un ContextMenu propriété qui lie la ContextMenu classe au contrôle qui affiche le menu contextuel.Visible controls and Form have a ContextMenu property that binds the ContextMenu class to the control that displays the shortcut menu. Plus d’un contrôle peut utiliser un ContextMenu.More than one control can use a ContextMenu. Vous pouvez utiliser le SourceControl propriété afin de déterminer quel contrôle dernier affiché le menu contextuel afin d’effectuer des tâches spécifiques au contrôle ou modifier le menu contextuel affiché pour le contrôle.You can use the SourceControl property to determine which control last displayed the shortcut menu in order to perform tasks specific to the control or to modify the shortcut menu displayed for the control.

Vous souhaiterez peut-être savoir quand le menu contextuel s’affiche afin de définir des coches, désactivez les éléments et effectuer d’autres tâches de menu avant le menu s’affiche à l’utilisateur.You might want to know when the shortcut menu is being displayed in order to set check marks, disable items, and perform other menu tasks before the menu is displayed to the user. Vous pouvez gérer le Popup événement pour déterminer quand le menu contextuel s’affiche.You can handle the Popup event to determine when the shortcut menu is being displayed.

Notes

Afin de le réutiliser MenuItem les objets qui sont affichés dans un MainMenu pour une utilisation dans un ContextMenu, vous devez créer une copie du menu en utilisant la CloneMenu méthode de la MenuItem classe.In order to reuse MenuItem objects that are displayed in a MainMenu for use in a ContextMenu, you must create a copy of the menu using the CloneMenu method of the MenuItem class. Vous pouvez également fusionner des éléments de menu et leurs éléments de sous-menu dans un seul MenuItem à l’aide de l’objet le MergeMenu méthode de la MenuItem classe.You can also merge menu items and their submenu items into a single MenuItem object using the MergeMenu method of the MenuItem class.

Constructeurs

ContextMenu() ContextMenu() ContextMenu() ContextMenu()

Initialise une nouvelle instance de la classe ContextMenu dans laquelle aucun élément de menu n'est spécifié.Initializes a new instance of the ContextMenu class with no menu items specified.

ContextMenu(MenuItem[]) ContextMenu(MenuItem[]) ContextMenu(MenuItem[]) ContextMenu(MenuItem[])

Initialise une nouvelle instance de la classe ContextMenu avec un jeu d'objets MenuItem spécifié.Initializes a new instance of the ContextMenu class with a specified set of MenuItem objects.

Propriétés

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Handle Handle Handle Handle

Obtient une valeur qui représente le handle de fenêtre pour le menu.Gets a value representing the window handle for the menu.

(Inherited from Menu)
IsParent IsParent IsParent IsParent

Obtient une valeur indiquant si ce menu contient des éléments de menu.Gets a value indicating whether this menu contains any menu items. Cette propriété est en lecture seule.This property is read-only.

(Inherited from Menu)
MdiListItem MdiListItem MdiListItem MdiListItem

Obtient une valeur indiquant le MenuItem utilisé pour afficher une liste de formulaires enfants MDI.Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Inherited from Menu)
MenuItems MenuItems MenuItems MenuItems

Obtient une valeur qui indique la collection d'objets MenuItem associée au menu.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Inherited from Menu)
Name Name Name Name

Obtient ou définit le nom de l'objet Menu.Gets or sets the name of the Menu.

(Inherited from Menu)
RightToLeft RightToLeft RightToLeft RightToLeft

Obtient ou définit une valeur indiquant si le texte géré par le contrôle est affiché de droite à gauche.Gets or sets a value indicating whether text displayed by the control is displayed from right to left.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
SourceControl SourceControl SourceControl SourceControl

Obtient le contrôle qui affiche le menu contextuel.Gets the control that is displaying the shortcut menu.

Tag Tag Tag Tag

Obtient ou définit les données définies par l'utilisateur associées au contrôle.Gets or sets user-defined data associated with the control.

(Inherited from Menu)

Méthodes

CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu)

Copie le Menu qui est passé comme paramètre au Menu en cours.Copies the Menu that is passed as a parameter to the current Menu.

(Inherited from Menu)
CreateMenuHandle() CreateMenuHandle() CreateMenuHandle() CreateMenuHandle()

Crée un nouveau handle pour Menu.Creates a new handle to the Menu.

(Inherited from Menu)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources (autres que la mémoire) utilisées par Menu.Disposes of the resources, other than memory, used by the Menu.

(Inherited from Menu)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr)

Obtient le MenuItem qui contient la valeur spécifiée.Gets the MenuItem that contains the value specified.

(Inherited from Menu)
FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32)

Retourne la position à laquelle un élément de menu doit être inséré dans le menu.Returns the position at which a menu item should be inserted into the menu.

(Inherited from Menu)
GetContextMenu() GetContextMenu() GetContextMenu() GetContextMenu()

Obtient le ContextMenu qui contient ce menu.Gets the ContextMenu that contains this menu.

(Inherited from Menu)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMainMenu() GetMainMenu() GetMainMenu() GetMainMenu()

Obtient le MainMenu qui contient ce menu.Gets the MainMenu that contains this menu.

(Inherited from Menu)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu)

Fusionne les objets MenuItem d'un menu avec le menu en cours.Merges the MenuItem objects of one menu with the current menu.

(Inherited from Menu)
OnCollapse(EventArgs) OnCollapse(EventArgs) OnCollapse(EventArgs) OnCollapse(EventArgs)

Déclenche l'événement Collapse.Raises the Collapse event.

OnPopup(EventArgs) OnPopup(EventArgs) OnPopup(EventArgs) OnPopup(EventArgs)

Déclenche l'événement Popup.Raises the Popup event

ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys)

Traite une touche de commande.Processes a command key.

(Inherited from Menu)
ProcessCmdKey(Message, Keys, Control) ProcessCmdKey(Message, Keys, Control) ProcessCmdKey(Message, Keys, Control) ProcessCmdKey(Message, Keys, Control)

Traite une touche de commande.Processes a command key.

Show(Control, Point) Show(Control, Point) Show(Control, Point) Show(Control, Point)

Affiche le menu contextuel à la position spécifiée.Displays the shortcut menu at the specified position.

Show(Control, Point, LeftRightAlignment) Show(Control, Point, LeftRightAlignment) Show(Control, Point, LeftRightAlignment) Show(Control, Point, LeftRightAlignment)

Affiche le menu contextuel à la position spécifiée et avec l'alignement spécifié.Displays the shortcut menu at the specified position and with the specified alignment.

ToString() ToString() ToString() ToString()

Retourne une String qui représente le contrôle Menu.Returns a String that represents the Menu control.

(Inherited from Menu)

Événements

Collapse Collapse Collapse Collapse

Se produit lorsque le menu contextuel est réduit.Occurs when the shortcut menu collapses.

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
Popup Popup Popup Popup

Se produit avant que le menu contextuel soit affiché.Occurs before the shortcut menu is displayed.

Champs

FindHandle FindHandle FindHandle FindHandle

Spécifie que la méthode FindMenuItem(Int32, IntPtr) doit rechercher un handle.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Inherited from Menu)
FindShortcut FindShortcut FindShortcut FindShortcut

Spécifie que la méthode FindMenuItem(Int32, IntPtr) doit rechercher un raccourci.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Inherited from Menu)

S’applique à

Voir aussi