ContextMenu Klasse

Definition

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

Vererbung

Object

MarshalByRefObject

Component

Menu

ContextMenu

Attribute

BrowsableAttribute ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel wird ein Ereignishandler für das Popup Ereignis der ContextMenu. Der Code im Ereignishandler bestimmt, welche von zwei Steuerelementen ein Benannter pictureBox1PictureBox und ein Benannter TextBoxtextBox1 das Steuerelement ist, das das Kontextmenü anzeigt. Je nachdem, welches Steuerelement dazu führte, dass das ContextMenu Kontextmenü angezeigt wurde, fügt das Steuerelement die entsprechenden MenuItem Objekte hinzu ContextMenu. In diesem Beispiel ist es erforderlich, dass Sie eine Instanz der ContextMenu Klasse ( benannt contextMenu1) innerhalb des Formulars definiert haben. In diesem Beispiel ist außerdem erforderlich, dass Sie ein Formular besitzen und einem Formular hinzugefügt haben und dass die Eigenschaft dieser Steuerelemente auf <a0/&0> festgelegt 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 auf die rechte 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. Sie können z. B. ein Kontextmenü verwenden, das einem TextBox Steuerelement zugewiesen ist, um Menüelemente zum Ändern der Schriftart des Texts, suchen nach Text innerhalb des Steuerelements oder Zwischenablagefeatures zum Kopieren und Einfügen von Text. Sie können auch neue MenuItem Objekte in einem Kontextmenü anzeigen, das sich nicht in einem MainMenu Kontextmenü befindet, um situationsspezifische Befehle bereitzustellen, die für die MainMenu Anzeige nicht geeignet sind.

In der Regel wird ein Kontextmenü angezeigt, wenn ein Benutzer über ein Steuerelement oder das Formular selbst auf die rechte Maustaste klickt. Sichtbare Steuerelemente und Form eine ContextMenu Eigenschaft, die die ContextMenu Klasse an das Steuerelement bindet, das das Kontextmenü anzeigt. Mehrere Steuerelemente können ein ContextMenu. Mit der SourceControl Eigenschaft können Sie bestimmen, welches Steuerelement zuletzt das Kontextmenü angezeigt hat, um Aufgaben auszuführen, die für das Steuerelement spezifisch sind, oder um 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ü dem Benutzer angezeigt wird. Sie können das Popup Ereignis behandeln, um zu bestimmen, wann das Kontextmenü angezeigt wird.

Weitere Informationen

• Menu
• MenuItem
• MainMenu