MenuItem Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

MenuItem.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.

Egy vagy több elemen belül MainMenuContextMenumegjelenő egyedi elemet jelöl.

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. Használja ToolStripMenuItem helyette a vezérlőt lecserélő parancsot MenuItem .

public ref class MenuItem : System::Windows::Forms::Menu

[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 class MenuItem : System.Windows.Forms.Menu

[<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 MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Öröklődés

Object

MarshalByRefObject

Component

Menu

MenuItem

Attribútumok

BrowsableAttribute ObsoleteAttribute

Példák

Az alábbi példakód egy menüstruktúrát hoz létre egy űrlaphoz. 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. A ToolStripMenuItem használható helyette.

Ahhoz, hogy egy MenuItem megjeleníthető legyen, hozzá kell adnia egy MainMenu vagy ContextMenu. Almenü MenuItem létrehozásához hozzáadhat objektumokat a MenuItems szülő MenuItemtulajdonságához.

Az MenuItem osztály olyan tulajdonságokat biztosít, amelyek lehetővé teszik egy menüelem megjelenésének és működésének konfigurálását. Ha egy menüelem mellett pipát szeretne megjeleníteni, használja a tulajdonságot Checked . Ezzel a funkcióval azonosíthatja a kölcsönösen kizáró menüelemek listájában kiválasztott menüelemet. Ha például egy vezérlőelemben TextBox a szöveg színének beállítására szolgáló menüelemekkel rendelkezik, a Checked tulajdonság segítségével meghatározhatja, hogy melyik szín van kiválasztva. A Shortcut tulajdonság egy olyan billentyűzetkombináció definiálására használható, amely a menüelem kiválasztásához lenyomható.

A Több dokumentumfelület (MDI) alkalmazásban megjelenített objektumok esetében MenuItem a MergeMenu metódussal egyesítheti az MDI-szülő menüit a gyermekűrlapok menüivel, így összevont menüstruktúrát hozhat létre. Mivel egy MenuItem példány nem használható egyszerre több helyen, például MainMenu egy és egy ContextMenuhelyen, a CloneMenu metódussal létrehozhat egy másolatot egy MenuItem másik helyen való használatra.

Az Popup esemény lehetővé teszi a feladatok végrehajtását a menü megjelenítése előtt. Létrehozhat például egy eseménykezelőt az eseményhez, amellyel megjelenítheti vagy elrejtheti a menüelemeket a kód állapota alapján. Az Select esemény lehetővé teszi olyan feladatok elvégzését, mint például az alkalmazás menüelemeinek részletes súgója, amikor a felhasználó az egérmutatót egy menüelem fölé helyezi.

Konstruktorok

Name	Description
MenuItem()	Elavult. Inicializál egy MenuItem üres feliratot.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Elavult. Inicializálja az MenuItem osztály új példányát egy megadott felirattal; a megadott eseménykezelőkkel a , Click és Select eseményekhezPopup; egy billentyűparancsot; egy egyesítési típust; és a menüelemhez megadott sorrendet.
MenuItem(String, EventHandler, Shortcut)	Elavult. Inicializálja az osztály új példányát egy megadott felirattal, eseménykezelővel és a menüelemhez társított billentyűparanccsal.
MenuItem(String, EventHandler)	Elavult. Inicializálja az osztály új példányát egy megadott felirattal és eseménykezelővel a Click menüelem eseményéhez.
MenuItem(String, MenuItem[])	Elavult. Inicializálja az osztály új példányát egy megadott felirattal és a menüelemhez definiált almenüelemek tömbjével.
MenuItem(String)	Elavult. Inicializálja az osztály új példányát a MenuItem menüelemhez megadott felirattal.

Mezők

Name	Description
FindHandle	Elavult. Megadja, hogy a FindMenuItem(Int32, IntPtr) metódusnak egy leírót kell keresnie. (Öröklődés forrása Menu)
FindShortcut	Elavult. Megadja, hogy a FindMenuItem(Int32, IntPtr) metódusnak egy parancsikont kell keresnie. (Öröklődés forrása Menu)

Tulajdonságok

Name	Description
BarBreak	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy az MenuItem új sorba (egy objektumhoz MainMenu hozzáadott menüelemhez) vagy egy új oszlopba (egy almenüelemhez vagy egy menüelemhez) kerül-e ContextMenu.
Break	Elavult. Beolvas vagy beállít egy értéket, amely jelzi, hogy az elem egy új sorba (egy objektumhoz MainMenu hozzáadott menüelemhez) vagy egy új oszlopba van-e helyezve ContextMenu(egy menüelemhez vagy egy almenüelemhez).
Checked	Elavult. Beolvas vagy beállít egy értéket, amely jelzi, hogy megjelenik-e pipa a menüelem szövege mellett.
DefaultItem	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a menüelem az alapértelmezett menüelem-e.
Enabled	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a menüelem engedélyezve van-e.
Handle	Elavult. Lekéri a menü ablakfogópontját jelképező értéket. (Öröklődés forrása Menu)
Index	Elavult. Beolvas vagy beállít egy értéket, amely jelzi a menüelem helyét a szülőmenüben.
IsParent	Elavult. Beolvas egy értéket, amely jelzi, hogy a menüelem tartalmaz-e gyermekmenüelemeket.
MdiList	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a menüelem a társított űrlapon belül megjelenő Több dokumentumfelület (MDI) gyermekablak listájával lesz-e feltöltve.
MdiListItem	Elavult. Lekéri a MenuItem több dokumentumfelületi (MDI-) gyermekűrlap listájának megjelenítéséhez használt értéket. (Öröklődés forrása Menu)
MenuID	Elavult. Lekéri a menüelem Windows azonosítójának értékét.
MenuItems	Elavult. Lekéri a menühöz társított objektumok gyűjteményét MenuItem jelző értéket. (Öröklődés forrása Menu)
MergeOrder	Elavult. Lekéri vagy beállít egy értéket, amely jelzi a menüelem relatív pozícióját, amikor az össze van vonva egy másikkal.
MergeType	Elavult. Lekéri vagy beállítja a menüelem viselkedését jelző értéket, amikor a menü egy másikkal egyesül.
Mnemonic	Elavult. A menüelemhez társított mnemonikus karaktert jelző értéket kap.
Name	Elavult. Lekéri vagy beállítja a Menunevét. (Öröklődés forrása Menu)
OwnerDraw	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a megadott kód megrajzolja-e a menüelemet, vagy Windows rajzolja-e a menüelemet.
Parent	Elavult. Lekéri a menüelemet tartalmazó menüt jelző értéket.
RadioCheck	Elavult. Beolvas vagy beállít egy értéket, amely jelzi, hogy a MenuItemjelölőnégyzet bejelölése helyett egy választógomb jelenik-e meg.
Shortcut	Elavult. Lekéri vagy beállítja a menüelemhez társított billentyűparancsot jelző értéket.
ShowShortcut	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a menüelemhez társított billentyűparancs megjelenik-e a menüelem felirata mellett.
Tag	Elavult. Lekéri vagy beállítja a vezérlőhöz társított felhasználó által definiált adatokat. (Öröklődés forrása Menu)
Text	Elavult. Lekéri vagy beállítja a menüelem feliratát jelző értéket.
Visible	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a menüelem látható-e.

Metódusok

Name	Description
CloneMenu()	Elavult. Másolatot készít az aktuálisról MenuItem.
CloneMenu(Menu)	Elavult. Az aktuálisnak Menuparaméterként átadott példányt másolja Menu át. (Öröklődés forrása Menu)
CloneMenu(MenuItem)	Elavult. Létrehozza a megadott MenuItempéldány másolatát.
CreateMenuHandle()	Elavult. Új fogópontot hoz létre a Menu. (Öröklődés forrása Menu)
FindMenuItem(Int32, IntPtr)	Elavult. Lekéri a MenuItem megadott értéket tartalmazó értéket. (Öröklődés forrása Menu)
FindMergePosition(Int32)	Elavult. Azt a helyet adja vissza, ahová be kell szúrni egy menüelemet. (Öröklődés forrása Menu)
GetContextMenu()	Elavult. Lekéri a ContextMenu menüt tartalmazó menüt. (Öröklődés forrása Menu)
GetMainMenu()	Elavult. Lekéri a MainMenu menüt tartalmazó menüt. (Öröklődés forrása Menu)
MergeMenu()	Elavult. Ezt MenuItem egyesíti egy másikkal MenuItem , és az eredményül kapott egyesített MenuItemértéket adja vissza.
MergeMenu(Menu)	Elavult. Egyesít egy MenuItem menü objektumait az aktuális menüvel. (Öröklődés forrása Menu)
MergeMenu(MenuItem)	Elavult. Egy másik menüelemet egyesít ezzel a menüponttal.
OnClick(EventArgs)	Elavult. Az eseményt emeli Click ki.
OnDrawItem(DrawItemEventArgs)	Elavult. Az eseményt emeli DrawItem ki.
OnInitMenuPopup(EventArgs)	Elavult. Az eseményt emeli Popup ki.
OnMeasureItem(MeasureItemEventArgs)	Elavult. Az eseményt emeli MeasureItem ki.
OnPopup(EventArgs)	Elavult. Az eseményt emeli Popup ki.
OnSelect(EventArgs)	Elavult. Az eseményt emeli Select ki.
PerformClick()	Elavult. Létrehoz egy eseményt Click a MenuItemfelhasználó által szimulált kattintáshoz.
PerformSelect()	Elavult. Select A menüelem eseményét emeli ki.
ProcessCmdKey(Message, Keys)	Elavult. Parancskulcsot dolgoz fel. (Öröklődés forrása Menu)

esemény

Name	Description
Click	Elavult. Akkor fordul elő, ha a menüelemre a menüelemhez definiált billentyűparanccsal vagy hozzáférési kulccsal kattint vagy van kiválasztva.
DrawItem	Elavult. Ez akkor fordul elő, ha egy OwnerDraw menüelem tulajdonsága be van állítva true , és a rendszer kérést küld a menüelem rajzolására.
MeasureItem	Elavult. Akkor fordul elő, ha a menünek ismernie kell egy menüelem méretét a rajz előtt.
Popup	Elavult. Ez a menüelem menüelem-listájának megjelenítése előtt következik be.
Select	Elavult. Akkor fordul elő, ha a felhasználó egy menüelem fölé helyezi az egérmutatót.

Lásd még

• MainMenu
• Menu
• MenuMerge
• ContextMenu