Freigeben über


MainMenu Klasse

Definition

Achtung

MainMenu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use MenuStrip instead.

Stellt die Menüstruktur eines Formulars dar.

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie MenuStrip stattdessen, wodurch das MainMenu Steuerelement ersetzt und erweitert wird.

public ref class MainMenu : System::Windows::Forms::Menu
public class MainMenu : System.Windows.Forms.Menu
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`MainMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `MenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class MainMenu : System.Windows.Forms.Menu
type MainMenu = class
    inherit Menu
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`MainMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `MenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type MainMenu = class
    inherit Menu
Public Class MainMenu
Inherits Menu
Vererbung
Attribute

Beispiele

Im folgenden Codebeispiel wird ein MainMenuObjekt erstellt, MenuItem dem MainMenu zwei Objekte zugewiesen und an ein Formular gebunden. Dieses Beispiel erfordert, dass Sie eine Form Erstellte haben, die mit dem Namen benannt Form1ist.

void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu^ mainMenu1 = gcnew MainMenu;
   MenuItem^ menuItem1 = gcnew MenuItem;
   MenuItem^ menuItem2 = gcnew MenuItem;
   menuItem1->Text = "File";
   menuItem2->Text = "Edit";

   // Add two MenuItem objects to the MainMenu.
   mainMenu1->MenuItems->Add( menuItem1 );
   mainMenu1->MenuItems->Add( menuItem2 );

   // Bind the MainMenu to Form1.
   Menu = mainMenu1;
}
public void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu mainMenu1 = new MainMenu();

   MenuItem menuItem1 = new MenuItem();
   MenuItem menuItem2 = new MenuItem();

   menuItem1.Text = "File";
   menuItem2.Text = "Edit";
   // Add two MenuItem objects to the MainMenu.
   mainMenu1.MenuItems.Add(menuItem1);
   mainMenu1.MenuItems.Add(menuItem2);
   
   // Bind the MainMenu to Form1.
   Menu = mainMenu1;   
}
Public Sub CreateMyMainMenu()
    ' Create an empty MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()
       
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    ' Add two MenuItem objects to the MainMenu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
       
    ' Bind the MainMenu to Form1.
    Menu = mainMenu1
End Sub

Hinweise

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

Das MainMenu Steuerelement stellt den Container für die Menüstruktur eines Formulars dar. Ein Menü besteht aus MenuItem Objekten, die die einzelnen Menübefehle in der Menüstruktur darstellen. Jeder MenuItem kann ein Befehl für Ihre Anwendung oder ein übergeordnetes Menü für andere Untermenüelemente sein. Um die Bindung an MainMenu das Form anzuzeigende Objekt zu erstellen, weisen Sie die MenuMainMenu Eigenschaft der Form.

Für Anwendungen, die Unterstützung für mehrere Sprachen haben, können Sie die RightToLeft Eigenschaft verwenden, um den Text des Menüs von rechts nach links anzuzeigen, um Sprachen wie Arabisch zu unterstützen.

Sie können verschiedene Objekte erstellen, um unterschiedliche MainMenu Menüstrukturen für Ihr Formular darzustellen. Wenn Sie die in einem bestimmten Element enthaltene Menüstruktur wiederverwenden MainMenumöchten, können Sie dessen CloneMenu Methode zum Erstellen einer Kopie verwenden. Sobald Sie eine Kopie der Menüstruktur haben, können Sie die entsprechenden Änderungen für die neue Menüstruktur vornehmen.

Hinweis

Das Ausschneiden und Einfügen von Menüelementen aus einem Formular in ein anderes im Designer funktioniert möglicherweise nicht wie erwartet, wenn das eingefügte Formular keine Menüelemente definiert hat.

Konstruktoren

Name Beschreibung
MainMenu()
Veraltet.

Initialisiert eine neue Instanz der MainMenu Klasse ohne angegebene Menüelemente.

MainMenu(IContainer)
Veraltet.

Initialisiert eine neue Instanz der MainMenu Klasse mit dem angegebenen Container.

MainMenu(MenuItem[])
Veraltet.

Initialisiert eine neue Instanz der MainMenu objekte mit einer angegebenen Gruppe von MenuItem Objekten.

Felder

Name Beschreibung
FindHandle
Veraltet.

Gibt an, dass die FindMenuItem(Int32, IntPtr) Methode nach einem Handle suchen soll.

(Geerbt von Menu)
FindShortcut
Veraltet.

Gibt an, dass die FindMenuItem(Int32, IntPtr) Methode nach einer Verknüpfung suchen soll.

(Geerbt von Menu)

Eigenschaften

Name Beschreibung
CanRaiseEvents
Veraltet.

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
Container
Veraltet.

Ruft das, das IContainer die Component.

(Geerbt von Component)
DesignMode
Veraltet.

Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet.

(Geerbt von Component)
Events
Veraltet.

Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind.

(Geerbt von Component)
Handle
Veraltet.

Ruft einen Wert ab, der das Fensterhandle für das Menü darstellt.

(Geerbt von Menu)
IsParent
Veraltet.

Ruft einen Wert ab, der angibt, ob dieses Menü menüelemente enthält. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Menu)
MdiListItem
Veraltet.

Ruft einen Wert ab, der angibt MenuItem , dass zum Anzeigen einer Liste mit untergeordneten Formularen für mehrere Dokumentschnittstellen (MDI) verwendet wird.

(Geerbt von Menu)
MenuItems
Veraltet.

Ruft einen Wert ab, der die Auflistung von MenuItem Objekten angibt, die dem Menü zugeordnet sind.

(Geerbt von Menu)
Name
Veraltet.

Dient zum Abrufen oder Festlegen des Namens der Menu.

(Geerbt von Menu)
RightToLeft
Veraltet.

Ruft ab oder legt fest, ob der vom Steuerelement angezeigte Text von rechts nach links angezeigt wird.

Site
Veraltet.

Dient zum ISite Abrufen oder Festlegen des Werts des Component.

(Geerbt von Component)
Tag
Veraltet.

Ruft benutzerdefinierte Daten ab, die dem Steuerelement zugeordnet sind, oder legt diese fest.

(Geerbt von Menu)

Methoden

Name Beschreibung
CloneMenu()
Veraltet.

Erstellt ein neues MainMenu , das ein Duplikat des aktuellen MainMenuist.

CloneMenu(Menu)
Veraltet.

Kopiert das Menu als Parameter übergebene Element in den aktuellen Menu.

(Geerbt von Menu)
CreateMenuHandle()
Veraltet.

Erstellt einen neuen Handle für das Menü.

CreateMenuHandle()
Veraltet.

Erstellt einen neuen Handle für die Menu.

(Geerbt von Menu)
CreateObjRef(Type)
Veraltet.

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
Dispose()
Veraltet.

Veröffentlicht alle ressourcen, die von der Component.

(Geerbt von Component)
Dispose(Boolean)
Veraltet.

Entfernt die Ressourcen, die nicht vom Arbeitsspeicher verwendet werden MainMenu.

Equals(Object)
Veraltet.

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
FindMenuItem(Int32, IntPtr)
Veraltet.

Ruft den MenuItem angegebenen Wert ab.

(Geerbt von Menu)
FindMergePosition(Int32)
Veraltet.

Gibt die Position zurück, an der ein Menüelement in das Menü eingefügt werden soll.

(Geerbt von Menu)
GetContextMenu()
Veraltet.

Ruft das Menü ab, das ContextMenu dieses Menü enthält.

(Geerbt von Menu)
GetForm()
Veraltet.

Ruft das Steuerelement ab, das Form dieses Steuerelement enthält.

GetHashCode()
Veraltet.

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetMainMenu()
Veraltet.

Ruft das Menü ab, das MainMenu dieses Menü enthält.

(Geerbt von Menu)
GetService(Type)
Veraltet.

Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird.

(Geerbt von Component)
GetType()
Veraltet.

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)
Veraltet.

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts.

(Geerbt von MarshalByRefObject)
MergeMenu(Menu)
Veraltet.

Führt die MenuItem Objekte eines Menüs mit dem aktuellen Menü zusammen.

(Geerbt von Menu)
OnCollapse(EventArgs)
Veraltet.

Löst das Collapse-Ereignis aus.

ProcessCmdKey(Message, Keys)
Veraltet.

Verarbeitet eine Befehlstaste.

(Geerbt von Menu)
ToString()
Veraltet.

Gibt eine Zeichenfolge zurück, die die MainMenu.

Ereignisse

Name Beschreibung
Collapse
Veraltet.

Tritt auf, wenn das Hauptmenü reduziert wird.

Disposed
Veraltet.

Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird.

(Geerbt von Component)

Gilt für:

Weitere Informationen