Menu Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Menu.cs

Figyelemfelhívás

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

Az összes menü alapfunkcióját jelöli.

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. Használja ToolStripDropDown és ToolStripDropDownMenu használja helyette, amely lecseréli és kibővíti a vezérlőt Menu .

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Öröklődés

Object

MarshalByRefObject

Component

Menu

Származtatott

System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Attribútumok

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Példák

Az alábbi példakód a származtatott osztályt MenuItemhasználja egy űrlap menüstruktúrájának létrehozásához. A példakód hozzáad egy MenuItem elemet a felső szintű menüelem megjelenítéséhez, hozzáad egy almenüelemet a betűméret kiválasztásához, majd hozzáad két almenüelemet ahhoz a menüelemhez, amelyek nagy és kis betűméretet jelölnek egy alkalmazásban. A példához el kell nevezni egy MainMenu objektumot, és négy mainMenu1 objektumot elnevezve MenuItem, menuItem1és menuItem2menuItem3.menuItem4

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Megjegyzések

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. Használja a ToolStripDropDown és a ToolStripDropDownMenu helyett.

Ez az osztály a , MainMenués MenuItem az ContextMenuosztályok alaposztálya. Az osztály egy példányát nem hozhatja létre. Az alkalmazások menüi objektumokból állnak MenuItem . Ezek más MenuItem objektumokat is tartalmazhatnak, amelyek almenüelemeket jelölnek. Az MenuItem objektumok egy űrlap teljes menüstruktúrájaként vagy helyi menük megjelenítésére használt teljes menüstruktúrában MainMenu tárolhatókContextMenu. Ez az osztály olyan funkciókat biztosít, amelyek az összes menüosztály esetében gyakoriak.

Sok alaposztálytól eltérően az osztály a Menu származtatott osztályaival határozza meg számos tulajdonságát. Ha a menüt egy több dokumentumból álló felületen (MDI) használja, a tulajdonság használatával MdiListItem megadhat egy MenuItem listát, amely megjeleníti a megnyitott MDI gyermekűrlapok listáját az alkalmazásban. A MenuItems tulajdonság a menüosztályban tárolt objektumok listáját MenuItem tartalmazza. Egy MainMenu vagy ContextMenu, ez a tulajdonság tartalmazza az MenuItem összes megjelenített objektumot. Egy MenuItemesetben a tulajdonság a MenuItems hozzá társított almenüelemeket jelöli.

Az összes származtatott menüosztályhoz biztosított tulajdonságok mellett az Menu osztály olyan metódusokat is biztosít, mint például CloneMenu az és MergeMenu, amelyek lehetővé teszik új menük létrehozását a meglévő menükből, és két menüstruktúrát is egyesíthet.

Az Menu osztály a beágyazott osztályt Menu.MenuItemCollectionis meghatározza. Ez az osztály határozza meg a tulajdonság által használt objektumok gyűjteményét MenuItemMenuItems . Az osztály metódusaival Menu.MenuItemCollection menüelemeket vehet fel és távolíthat el egy vagy MainMenuContextMenutöbb MenuItemmenüből.

Konstruktorok

Name	Description
Menu(MenuItem[])	Elavult. Inicializálja a Menu osztály új példányát.

Mezők

Name	Description
FindHandle	Elavult. Megadja, hogy a FindMenuItem(Int32, IntPtr) metódusnak egy leírót kell keresnie.
FindShortcut	Elavult. Megadja, hogy a FindMenuItem(Int32, IntPtr) metódusnak egy parancsikont kell keresnie.

Tulajdonságok

Name	Description
Handle	Elavult. Lekéri a menü ablakfogópontját jelképező értéket.
IsParent	Elavult. Beolvas egy értéket, amely jelzi, hogy ez a menü tartalmaz-e menüelemeket. Ez a tulajdonság írásvédett.
MdiListItem	Elavult. Lekéri a MenuItem több dokumentumfelületi (MDI-) gyermekűrlap listájának megjelenítéséhez használt értéket.
MenuItems	Elavult. Lekéri a menühöz társított objektumok gyűjteményét MenuItem jelző értéket.
Name	Elavult. Lekéri vagy beállítja a Menunevét.
Tag	Elavult. Lekéri vagy beállítja a vezérlőhöz társított felhasználó által definiált adatokat.

Metódusok

Name	Description
CloneMenu(Menu)	Elavult. Az aktuálisnak Menuparaméterként átadott példányt másolja Menu át.
CreateMenuHandle()	Elavult. Új fogópontot hoz létre a Menu.
FindMenuItem(Int32, IntPtr)	Elavult. Lekéri a MenuItem megadott értéket tartalmazó értéket.
FindMergePosition(Int32)	Elavult. Azt a helyet adja vissza, ahová be kell szúrni egy menüelemet.
GetContextMenu()	Elavult. Lekéri a ContextMenu menüt tartalmazó menüt.
GetMainMenu()	Elavult. Lekéri a MainMenu menüt tartalmazó menüt.
MergeMenu(Menu)	Elavult. Egyesít egy MenuItem menü objektumait az aktuális menüvel.
ProcessCmdKey(Message, Keys)	Elavult. Parancskulcsot dolgoz fel.

Lásd még

• MainMenu
• ContextMenu
• MenuItem