ContextMenu Klasse

Definition

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

Vererbung

Object

MarshalByRefObject

Component

Menu

ContextMenu

Beispiele

Im folgenden Codebeispiel wird ein Ereignishandler für das Popup -Ereignis von ContextMenuerstellt. Der Code im Ereignishandler bestimmt, welches der beiden Steuerelemente ein PictureBox benanntes pictureBox1 und ein TextBox benanntes textBox1 das Steuerelement ist, das das Kontextmenü anzeigt. Je nachdem, welches Steuerelement die Anzeige des ContextMenu Kontextmenüs verursacht hat, fügt das Steuerelement die entsprechenden MenuItem Objekte zu hinzu ContextMenu. In diesem Beispiel muss eine instance der -Klasse mit dem ContextMenu Namen contextMenu1definiert sein. Dieses Beispiel erfordert auch, dass Sie ein TextBox - und PictureBox zu einem Formular hinzugefügt haben und dass die ContextMenu Eigenschaft dieser Steuerelemente auf contextMenu1festgelegt ist.

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

Hinweise

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie stattdessen ContextMenuStrip.

Die ContextMenu -Klasse stellt Kontextmenüs dar, die angezeigt werden können, wenn der Benutzer mit der rechten Maustaste über ein Steuerelement oder einen Bereich des Formulars klickt. Kontextmenüs werden in der Regel verwendet, um verschiedene Menüelemente aus einem MainMenu Formular zu kombinieren, die für den Benutzer im Kontext der Anwendung nützlich sind. Beispielsweise können Sie ein Kontextmenü verwenden, das einem TextBox Steuerelement zugewiesen ist, um Menüelemente zum Ändern der Schriftart des Texts, zum Suchen von Text im Steuerelement oder zum Kopieren und Einfügen von Text bereitzustellen. Sie können auch neue MenuItem Objekte in einem Kontextmenü anzeigen, die sich nicht in einem MainMenu befinden, um situationsspezifische Befehle bereitzustellen, die für die MainMenu Anzeige nicht geeignet sind.

In der Regel wird ein Kontextmenü angezeigt, wenn ein Benutzer mit der rechten Maustaste über ein Steuerelement oder das Formular selbst klickt. Sichtbare Steuerelemente und Form verfügen über eine ContextMenu Eigenschaft, die die ContextMenu -Klasse an das Steuerelement bindet, das das Kontextmenü anzeigt. Mehrere Steuerelemente können ein ContextMenuverwenden. Sie können die SourceControl -Eigenschaft verwenden, um zu bestimmen, welches Steuerelement das Kontextmenü zuletzt angezeigt hat, um aufgabenspezifisch für das Steuerelement auszuführen oder das für das Steuerelement angezeigte Kontextmenü zu ändern.

Möglicherweise möchten Sie wissen, wann das Kontextmenü angezeigt wird, um Häkchen festzulegen, Elemente zu deaktivieren und andere Menüaufgaben auszuführen, bevor das Menü für den Benutzer angezeigt wird. Sie können das Popup Ereignis behandeln, um zu bestimmen, wann das Kontextmenü angezeigt wird.

Konstruktoren

Felder

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• Menu
• MenuItem
• MainMenu