ContextMenu Klas

Definitie

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

Overname

Object

MarshalByRefObject

Component

Menu

ContextMenu

Voorbeelden

In het volgende codevoorbeeld wordt een gebeurtenis-handler gemaakt voor de gebeurtenis van de PopupContextMenu. De code in de gebeurtenis-handler bepaalt welke van twee besturingselementen een PictureBox benoemde pictureBox1 en een TextBox benoemde is het besturingselement textBox1 dat het snelmenu weergeeft. Afhankelijk van het besturingselement waardoor het ContextMenu snelmenu wordt weergegeven, worden de juiste MenuItem objecten aan het ContextMenubesturingselement toegevoegd. Voor dit voorbeeld moet u een exemplaar van de klasse hebben met de ContextMenu naam contextMenu1, gedefinieerd in het formulier. In dit voorbeeld moet u ook een TextBox formulier hebben en PictureBox toevoegen en dat de ContextMenu eigenschap van deze besturingselementen is ingesteld op 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

Opmerkingen

Deze klasse is niet beschikbaar in .NET Core 3.1 en nieuwere versies. Gebruik in plaats daarvan ContextMenuStrip.

De ContextMenu klasse vertegenwoordigt snelmenu's die kunnen worden weergegeven wanneer de gebruiker op de rechtermuisknop op een besturingselement of gebied van het formulier klikt. Snelmenu's worden meestal gebruikt om verschillende menu-items te combineren van een MainMenu formulier dat nuttig is voor de gebruiker in de context van de toepassing. U kunt bijvoorbeeld een snelmenu gebruiken dat is toegewezen aan een TextBox besturingselement om menu-items op te geven voor het wijzigen van het lettertype van de tekst, het zoeken van tekst in het besturingselement of klembordfuncties voor het kopiëren en plakken van tekst. U kunt ook nieuwe MenuItem objecten weergeven in een snelmenu dat zich niet in een MainMenu context bevindt om specifieke opdrachten te bieden die niet geschikt zijn voor de MainMenu weergave.

Normaal gesproken wordt een snelmenu weergegeven wanneer een gebruiker op de rechtermuisknop op een besturingselement of het formulier zelf klikt. Zichtbare besturingselementen en Form een ContextMenu eigenschap hebben waarmee de ContextMenu klasse wordt gekoppeld aan het besturingselement dat het snelmenu weergeeft. Meer dan één besturingselement kan een ContextMenu. U kunt de SourceControl eigenschap gebruiken om te bepalen welk besturingselement het snelmenu het laatst heeft weergegeven om taken uit te voeren die specifiek zijn voor het besturingselement of om het snelmenu te wijzigen dat voor het besturingselement wordt weergegeven.

Mogelijk wilt u weten wanneer het snelmenu wordt weergegeven om vinkjes in te stellen, items uit te schakelen en andere menutaken uit te voeren voordat het menu aan de gebruiker wordt weergegeven. U kunt de Popup gebeurtenis afhandelen om te bepalen wanneer het snelmenu wordt weergegeven.

Zie ook

• Menu
• MenuItem
• MainMenu