ContextMenu Classe

Définition

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

Object

MarshalByRefObject

Component

Menu

ContextMenu

Exemples

L’exemple de code suivant crée un gestionnaire d’événements pour l’événement Popup de .ContextMenu Le code dans le gestionnaire d’événements détermine lequel des deux contrôles est un PictureBox nommé pictureBox1 et un TextBox nommé textBox1 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 MenuItemContextMenuau . Cet exemple nécessite que vous ayez une instance de la ContextMenu classe, nommée contextMenu1, définie dans le formulaire. Cet exemple exige également que vous ayez un TextBox et PictureBox ajouté à un formulaire et que la ContextMenu propriété de ces contrôles soit définie sur 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

Remarques

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez plutôt ContextMenuStrip.

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 compte tenu 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 permettant de modifier la police du texte, de 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 pour fournir des commandes spécifiques à une MainMenu 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. 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 dernier contrôle a affiché le 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 afin de définir case activée marques, de désactiver les éléments et d’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 s’affiche.

Constructeurs

Champs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• Menu
• MenuItem
• MainMenu