MainMenu Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

MainMenu.cs

Upozornění

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

Představuje strukturu nabídky formuláře.

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Místo toho použijte MenuStrip , který nahrazuje a rozšiřuje MainMenu ovládací prvek.

public ref 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

[<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

Dědičnost

Object

MarshalByRefObject

Component

Menu

MainMenu

Atributy

BrowsableAttribute ObsoleteAttribute

Příklady

Následující příklad kódu vytvoří , MainMenupřiřadí dva MenuItem objekty a MainMenu vytvoří vazbu na formulář. Tento příklad vyžaduje, abyste vytvořili Form název Form1.

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

Poznámky

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Místo toho použijte MenuStrip.

Ovládací MainMenu prvek představuje kontejner pro strukturu nabídky formuláře. Nabídka se skládá z MenuItem objektů, které představují jednotlivé příkazy nabídky ve struktuře nabídek. Každý z nich MenuItem může být příkaz pro vaši aplikaci nebo nadřazená nabídka pro jiné podnabídky. Chcete-li vytvořit vazbu MainMenu k zobrazenému objektu Form , přiřaďte MainMenu vlastnost MenuFormvlastnosti .

U aplikací, které budou podporovat více jazyků, můžete pomocí RightToLeft vlastnosti zobrazit text nabídky zprava doleva a podporovat jazyky, jako je arabština.

Můžete vytvořit různé MainMenu objekty, které budou představovat různé struktury nabídek pro formulář. Pokud chcete znovu použít strukturu nabídek obsaženou v určitém MainMenuobjektu , můžete k vytvoření kopie použít její CloneMenu metodu. Jakmile budete mít kopii struktury nabídek, můžete provést příslušné změny pro novou strukturu nabídek.

Poznámka:

Vyjmutí a vložení položek nabídky z jednoho formuláře do jiného v návrháři nemusí fungovat podle očekávání, pokud formulář, do který vkládáte, nemá definované žádné položky nabídky.

Konstruktory

Name	Description
MainMenu()	Zastaralé. Inicializuje novou instanci MainMenu třídy bez zadaných položek nabídky.
MainMenu(IContainer)	Zastaralé. Inicializuje novou instanci MainMenu třídy se zadaným kontejnerem.
MainMenu(MenuItem[])	Zastaralé. Inicializuje novou instanci MainMenu se zadanou sadou MenuItem objektů.

Pole

Name	Description
FindHandle	Zastaralé. Určuje, že FindMenuItem(Int32, IntPtr) metoda by měla hledat popisovač. (Zděděno od Menu)
FindShortcut	Zastaralé. Určuje, že FindMenuItem(Int32, IntPtr) metoda by měla vyhledat zástupce. (Zděděno od Menu)

Vlastnosti

Name	Description
Handle	Zastaralé. Získá hodnotu představující popisovač okna pro nabídku. (Zděděno od Menu)
IsParent	Zastaralé. Získá hodnotu určující, zda tato nabídka obsahuje jakékoli položky nabídky. Tato vlastnost je jen ke čtení. (Zděděno od Menu)
MdiListItem	Zastaralé. Získá hodnotu označující MenuItem , který se používá k zobrazení seznamu více podřízených formulářů rozhraní dokumentů (MDI). (Zděděno od Menu)
MenuItems	Zastaralé. Získá hodnotu označující kolekci objektů přidružených MenuItem k nabídce. (Zděděno od Menu)
Name	Zastaralé. Získá nebo nastaví název Menu. (Zděděno od Menu)
RightToLeft	Zastaralé. Získá nebo nastaví, zda text zobrazený ovládacím prvku je zobrazen zprava doleva.
Tag	Zastaralé. Získá nebo nastaví uživatelem definovaná data přidružená k ovládacímu prvku. (Zděděno od Menu)

Metody

Name	Description
CloneMenu()	Zastaralé. Vytvoří novou MainMenu , která je duplikátem aktuálního MainMenu.
CloneMenu(Menu)	Zastaralé. Menu Zkopíruje předaný jako parametr do aktuálního Menusouboru . (Zděděno od Menu)
CreateMenuHandle()	Zastaralé. Vytvoří nový popisovač .Menu (Zděděno od Menu)
FindMenuItem(Int32, IntPtr)	Zastaralé. MenuItem Získá hodnotu, která obsahuje zadanou hodnotu. (Zděděno od Menu)
FindMergePosition(Int32)	Zastaralé. Vrátí pozici, do které se má položka nabídky vložit. (Zděděno od Menu)
GetContextMenu()	Zastaralé. ContextMenu Získá hodnotu, která obsahuje tuto nabídku. (Zděděno od Menu)
GetForm()	Zastaralé. Form Získá ten, který obsahuje tento ovládací prvek.
GetMainMenu()	Zastaralé. MainMenu Získá hodnotu, která obsahuje tuto nabídku. (Zděděno od Menu)
MergeMenu(Menu)	Zastaralé. Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou. (Zděděno od Menu)
OnCollapse(EventArgs)	Zastaralé. Collapse Vyvolá událost.
ProcessCmdKey(Message, Keys)	Zastaralé. Zpracovává příkazový klíč. (Zděděno od Menu)

Událost

Name	Description
Collapse	Zastaralé. Nastane, když se hlavní nabídka sbalí.

Viz také

• MenuItem
• Add(String)
• Menu
• MenuItems
• MenuStrip
• ContextMenuStrip
• MenuStrip – ovládací prvek (Windows Forms)