ContextMenu Klasse

Definition

Stellt ein Kontextmenü dar.Represents a shortcut menu.

Diese Klasse ist in .net Core 3,1 und höheren Versionen nicht verfügbar.This class is not available in .NET Core 3.1 and later versions. Verwenden Sie ContextMenuStrip stattdessen, wodurch das Steuerelement ersetzt und erweitert wird ContextMenu .Use ContextMenuStrip instead, which replaces and extends the ContextMenu control.

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

Beispiele

Im folgenden Codebeispiel wird ein Ereignishandler für das- Popup Ereignis von erstellt ContextMenu .The following code example creates an event handler for the Popup event of the ContextMenu. Der Code im-Ereignishandler bestimmt, welche der beiden Steuerelemente ein mit dem PictureBox Namen pictureBox1 und ein TextBox benanntes Steuerelement sind, das textBox1 das Kontextmenü anzeigt.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. Abhängig davon, welches Steuerelement bewirkt hat, dass das Kontext ContextMenu Menü angezeigt wird, fügt das Steuerelement die entsprechenden MenuItem Objekte hinzu ContextMenu .Depending on which control caused the ContextMenu to display its shortcut menu, the control adds the appropriate MenuItem objects to the ContextMenu. Für dieses Beispiel ist es erforderlich, dass Sie über eine Instanz der-Klasse mit dem ContextMenu Namen verfügen contextMenu1 , die im Formular definiert ist.This example requires that you have an instance of the ContextMenu class, named contextMenu1, defined within the form. Dieses Beispiel erfordert auch, dass Sie einen haben TextBox und PictureBox zu einem Formular hinzugefügt haben und dass die- ContextMenu Eigenschaft dieser Steuerelemente auf festgelegt ist 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

Hinweise

Diese Klasse ist in .net Core 3,1 und höheren Versionen nicht verfügbar.This class is not available in .NET Core 3.1 and later versions. Verwenden Sie stattdessen .Use instead.

Die- ContextMenu Klasse stellt Kontextmenüs dar, die angezeigt werden können, wenn der Benutzer mit der rechten Maustaste auf ein Steuerelement oder einen Bereich des Formulars klickt.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. Kontextmenüs werden in der Regel verwendet, um unterschiedliche Menü Elemente aus einem eines Formulars zu kombinieren MainMenu , die für den Benutzer hilfreich sind, wenn der Kontext der Anwendung verwendet wird.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. Beispielsweise können Sie ein Kontextmenü, das einem Steuerelement zugewiesen ist, verwenden, TextBox um Menü Elemente zum Ändern der Schriftart des Texts, zum Suchen von Text innerhalb des Steuer Elements oder Zwischenablage Funktionen zum Kopieren und Einfügen von Text bereitzustellen.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. Sie können auch neue MenuItem Objekte in einem Kontextmenü anzeigen, das sich nicht in einem befindet, MainMenu um bestimmte Befehle bereitzustellen, die für die Anzeige nicht geeignet sind MainMenu .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.

In der Regel wird ein Kontextmenü angezeigt, wenn ein Benutzer mit der rechten Maustaste auf ein Steuerelement oder das Formular selbst klickt.Typically, a shortcut menu is displayed when a user clicks the right mouse button over a control or the form itself. Sichtbare Steuerelemente und Form verfügen über eine ContextMenu Eigenschaft, die die ContextMenu Klasse an das Steuerelement bindet, das das Kontextmenü anzeigt.Visible controls and Form have a ContextMenu property that binds the ContextMenu class to the control that displays the shortcut menu. Mehr als ein Steuerelement kann einen verwenden ContextMenu .More than one control can use a ContextMenu. Sie können die- SourceControl Eigenschaft verwenden, um zu bestimmen, welches Steuerelement zuletzt das Kontextmenü angezeigt hat, um spezielle Aufgaben für das Steuerelement auszuführen oder das für das Steuerelement angezeigte Kontextmenü zu ändern.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.

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 dem Benutzer das Menü angezeigt wird.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. Sie können das- Popup Ereignis behandeln, um zu bestimmen, wann das Kontextmenü angezeigt wird.You can handle the Popup event to determine when the shortcut menu is being displayed.

Hinweis

Um Objekte wiederzuverwenden, die MenuItem in einem MainMenu zur Verwendung in einer angezeigt werden ContextMenu , müssen Sie mithilfe der-Methode der-Klasse eine Kopie des Menüs erstellen CloneMenu MenuItem .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. Sie können Menü Elemente und ihre unter Menü Elemente auch MenuItem mithilfe der- MergeMenu Methode der-Klasse in einem einzelnen-Objekt zusammenführen MenuItem .You can also merge menu items and their submenu items into a single MenuItem object using the MergeMenu method of the MenuItem class.

Konstruktoren

ContextMenu()

Initialisiert eine neue Instanz der ContextMenu-Klasse ohne Angabe von Menüelementen.Initializes a new instance of the ContextMenu class with no menu items specified.

ContextMenu(MenuItem[])

Initialisiert eine neue Instanz der ContextMenu-Klasse mit dem angegebenen Satz von MenuItem-Objekten.Initializes a new instance of the ContextMenu class with a specified set of MenuItem objects.

Felder

FindHandle

Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einem Handle suchen soll.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Geerbt von Menu)
FindShortcut

Gibt an, dass die FindMenuItem(Int32, IntPtr)-Methode nach einer Verknüpfung suchen soll.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Geerbt von Menu)

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.Gets the IContainer that contains the Component.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
Handle

Ruft einen Wert ab, der das Fensterhandle für das Menü darstellt.Gets a value representing the window handle for the menu.

(Geerbt von Menu)
IsParent

Ruft einen Wert ab, der angibt, ob dieses Menü Menüelemente enthält.Gets a value indicating whether this menu contains any menu items. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

(Geerbt von Menu)
MdiListItem

Ruft einen Wert ab, der das MenuItem angibt, mit dem eine Liste von untergeordneten MDI-Formularen (Multiple Document Interface) angezeigt wird.Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Geerbt von Menu)
MenuItems

Ruft einen Wert ab, der die Auflistung der dem Menü zugeordneten MenuItem-Objekte angibt.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Geerbt von Menu)
Name

Ruft den Namen der Menu ab oder legt diesen fest.Gets or sets the name of the Menu.

(Geerbt von Menu)
RightToLeft

Ruft einen Wert ab, der angibt, ob der Text im Steuerelement von rechts nach links angezeigt wird, oder legt diesen fest.Gets or sets a value indicating whether text displayed by the control is displayed from right to left.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
SourceControl

Ruft das Steuerelement ab, das das Kontextmenü anzeigt.Gets the control that is displaying the shortcut menu.

Tag

Ruft benutzerdefinierte, dem Steuerelement zugeordnete Daten ab oder legt diese fest.Gets or sets user-defined data associated with the control.

(Geerbt von Menu)

Methoden

CloneMenu(Menu)

Kopiert das Menu, das als Parameter an das aktuelle Menu übergeben wird.Copies the Menu that is passed as a parameter to the current Menu.

(Geerbt von Menu)
CreateMenuHandle()

Erstellt ein neues Handle für Menu.Creates a new handle to the Menu.

(Geerbt von Menu)
CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt mit Ausnahme des Speichers die von der Menu-Klasse verwendeten Ressourcen frei.Disposes of the resources, other than memory, used by the Menu.

(Geerbt von Menu)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindMenuItem(Int32, IntPtr)

Ruft das MenuItem ab, das den angegebenen Wert enthält.Gets the MenuItem that contains the value specified.

(Geerbt von Menu)
FindMergePosition(Int32)

Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll.Returns the position at which a menu item should be inserted into the menu.

(Geerbt von Menu)
GetContextMenu()

Ruft das ContextMenu ab, das dieses Menü enthält.Gets the ContextMenu that contains this menu.

(Geerbt von Menu)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetMainMenu()

Ruft das MainMenu ab, das dieses Menü enthält.Gets the MainMenu that contains this menu.

(Geerbt von Menu)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
MergeMenu(Menu)

Führt die MenuItem-Objekte eines Menüs mit dem aktuellen Menü zusammen.Merges the MenuItem objects of one menu with the current menu.

(Geerbt von Menu)
OnCollapse(EventArgs)

Löst das Collapse-Ereignis aus.Raises the Collapse event.

OnPopup(EventArgs)

Löst das Popup-Ereignis aus.Raises the Popup event.

ProcessCmdKey(Message, Keys)

Verarbeitet eine Befehlstaste.Processes a command key.

(Geerbt von Menu)
ProcessCmdKey(Message, Keys, Control)

Verarbeitet eine Befehlstaste.Processes a command key.

Show(Control, Point)

Zeigt das Kontextmenü an der angegebenen Position an.Displays the shortcut menu at the specified position.

Show(Control, Point, LeftRightAlignment)

Zeigt das Kontextmenü an der angegebenen Position und mit der angegebenen Ausrichtung an.Displays the shortcut menu at the specified position and with the specified alignment.

ToString()

Gibt einen String zurück, der das Menu-Steuerelement darstellt.Returns a String that represents the Menu control.

(Geerbt von Menu)

Ereignisse

Collapse

Tritt ein, wenn das Kontextmenü geschlossen wird.Occurs when the shortcut menu collapses.

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)
Popup

Tritt ein, bevor das Kontextmenü angezeigt wird.Occurs before the shortcut menu is displayed.

Gilt für:

Siehe auch