MenuItem Klas

Definitie

Naamruimte:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een afzonderlijk item dat wordt weergegeven in een MainMenu of ContextMenu.

Deze klasse is niet beschikbaar in .NET Core 3.1 en nieuwere versies. Gebruik ToolStripMenuItem in plaats daarvan het MenuItem besturingselement.

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

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Overname: Object

MarshalByRefObject

Component

Menu
MenuItem

Voorbeelden

In het volgende codevoorbeeld wordt een menustructuur voor een formulier gemaakt. De voorbeeldcode voegt een MenuItem item toe om het menu-item op het hoogste niveau weer te geven, voegt er een submenu-item aan toe voor het selecteren van een tekengrootte en voegt vervolgens twee submenu-items toe aan dat menu-item dat grote en kleine lettertypekeuzen in een toepassing vertegenwoordigt. Het voorbeeld vereist dat er een object met de MainMenu naam en vier MenuItem objecten met de naam menuItem1, menuItem2en menuItem3menuItem4.mainMenu1

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

Opmerkingen

Deze klasse is niet beschikbaar in .NET Core 3.1 en nieuwere versies. Gebruik in plaats daarvan ToolStripMenuItem.

Als u een MenuItem wilt weergeven, moet u deze toevoegen aan een MainMenu of ContextMenu. Als u submenu's wilt maken, kunt u objecten toevoegen MenuItem aan de MenuItems eigenschap van het bovenliggende MenuItemitem.

De MenuItem klasse biedt eigenschappen waarmee u het uiterlijk en de functionaliteit van een menu-item kunt configureren. Als u een vinkje naast een menu-item wilt weergeven, gebruikt u de Checked eigenschap. U kunt deze functie gebruiken om een menu-item te identificeren dat is geselecteerd in een lijst met wederzijds exclusieve menu-items. Als u bijvoorbeeld een set menu-items hebt voor het instellen van de kleur van tekst in een TextBox besturingselement, kunt u de Checked eigenschap gebruiken om te bepalen welke kleur momenteel is geselecteerd. De Shortcut eigenschap kan worden gebruikt om een toetsenbordcombinatie te definiëren die kan worden ingedrukt om het menu-item te selecteren.

Voor MenuItem objecten die worden weergegeven in een MDI-toepassing (Multiple Document Interface), kunt u de MergeMenu methode gebruiken om de menu's van een MDI-bovenliggend element samen te voegen met die van de onderliggende formulieren om een geconsolideerde menustructuur te maken. Omdat een MenuItem bestand niet opnieuw kan worden gebruikt op meerdere locaties tegelijk, zoals in een MainMenu en een ContextMenu, kunt u de CloneMenu methode gebruiken om een kopie van een MenuItem te maken voor gebruik op een andere locatie.

Met deze Popup gebeurtenis kunt u taken uitvoeren voordat een menu wordt weergegeven. U kunt bijvoorbeeld een gebeurtenis-handler voor deze gebeurtenis maken om menu-items weer te geven of te verbergen op basis van de status van uw code. Met Select deze gebeurtenis kunt u taken uitvoeren, zoals gedetailleerde hulp voor de menu-items van uw toepassing wanneer de gebruiker de muisaanwijzer boven een menu-item plaatst.

Constructors

Name	Description
MenuItem()	Initialiseert een MenuItem met een leeg bijschrift.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Initialiseert een nieuw exemplaar van de MenuItem klasse met een opgegeven bijschrift; gedefinieerde gebeurtenis-handlers voor de Click, Select en Popup gebeurtenissen; een sneltoets; een samenvoegingstype; en volgorde die is opgegeven voor het menu-item.
MenuItem(String, EventHandler, Shortcut)	Initialiseert een nieuw exemplaar van de klasse met een opgegeven bijschrift, gebeurtenishandler en bijbehorende sneltoets voor het menu-item.
MenuItem(String, EventHandler)	Initialiseert een nieuw exemplaar van de klasse met een opgegeven bijschrift en gebeurtenis-handler voor de Click gebeurtenis van de menuopdracht.
MenuItem(String, MenuItem[])	Initialiseert een nieuw exemplaar van de klasse met een opgegeven bijschrift en een matrix met submenu-items die zijn gedefinieerd voor het menu-item.
MenuItem(String)	Initialiseert een nieuw exemplaar van de MenuItem klasse met een opgegeven bijschrift voor het menu-item.

Velden

Name	Description
FindHandle	Hiermee geeft u op dat de FindMenuItem(Int32, IntPtr) methode moet zoeken naar een ingang. (Overgenomen van Menu)
FindShortcut	Hiermee geeft u op dat de FindMenuItem(Int32, IntPtr) methode moet zoeken naar een snelkoppeling. (Overgenomen van Menu)

Eigenschappen

Name	Description
BarBreak	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de MenuItem waarde op een nieuwe regel wordt geplaatst (voor een menu-item dat aan een MainMenu object is toegevoegd) of in een nieuwe kolom (voor een submenu-item of menu-item dat wordt weergegeven in een ContextMenu).
Break	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het item op een nieuwe regel wordt geplaatst (voor een menu-item dat is toegevoegd aan een MainMenu object) of in een nieuwe kolom (voor een menu-item of submenu-item dat wordt weergegeven in een ContextMenu).
CanRaiseEvents	Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren. (Overgenomen van Component)
Checked	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of er een vinkje wordt weergegeven naast de tekst van het menu-item.
Container	Hiermee haalt u het IContainer bestand op dat de Component. (Overgenomen van Component)
DefaultItem	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het menu-item de standaardmenuopdracht is.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is. (Overgenomen van Component)
Enabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het menu-item is ingeschakeld.
Events	Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld. (Overgenomen van Component)
Handle	Hiermee haalt u een waarde op die de venstergreep voor het menu vertegenwoordigt. (Overgenomen van Menu)
Index	Hiermee wordt een waarde opgehaald of ingesteld die de positie van het menu-item in het bovenliggende menu aangeeft.
IsParent	Hiermee wordt een waarde opgehaald die aangeeft of het menu-item onderliggende menu-items bevat.
MdiList	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het menu-item wordt gevuld met een lijst met de onderliggende vensters multiple document interface (MDI) die worden weergegeven in het bijbehorende formulier.
MdiListItem	Hiermee wordt een waarde opgehaald die aangeeft MenuItem dat wordt gebruikt om een lijst met onderliggende MDI-formulieren (Multiple Document Interface) weer te geven. (Overgenomen van Menu)
MenuID	Hiermee wordt een waarde opgehaald die de Windows-id voor dit menu-item aangeeft.
MenuItems	Hiermee haalt u een waarde op die de verzameling MenuItem objecten aangeeft die aan het menu zijn gekoppeld. (Overgenomen van Menu)
MergeOrder	Hiermee wordt een waarde opgehaald of ingesteld die de relatieve positie van het menu-item aangeeft wanneer deze wordt samengevoegd met een andere.
MergeType	Hiermee wordt een waarde opgehaald of ingesteld die het gedrag van dit menu-item aangeeft wanneer het menu wordt samengevoegd met een andere.
Mnemonic	Hiermee wordt een waarde opgehaald die het nemonic-teken aangeeft dat is gekoppeld aan dit menu-item.
Name	Hiermee haalt u de naam van de Menu. (Overgenomen van Menu)
OwnerDraw	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de code die u opgeeft, het menu-item tekent of Windows het menu-item tekent.
Parent	Hiermee wordt een waarde opgehaald die het menu bevat dat dit menu-item bevat.
RadioCheck	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het MenuItemkeuzerondje , indien ingeschakeld, een keuzerondje weergeeft in plaats van een vinkje.
Shortcut	Hiermee wordt een waarde opgehaald of ingesteld die de sneltoets aangeeft die is gekoppeld aan het menu-item.
ShowShortcut	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de sneltoets die is gekoppeld aan het menu-item wordt weergegeven naast het bijschrift van het menu-item.
Site	Haalt of stelt de ISite van de Component. (Overgenomen van Component)
Tag	Hiermee worden door de gebruiker gedefinieerde gegevens opgehaald of ingesteld die aan het besturingselement zijn gekoppeld. (Overgenomen van Menu)
Text	Hiermee wordt een waarde opgehaald of ingesteld die het bijschrift van het menu-item aangeeft.
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het menu-item zichtbaar is.

Methoden

Name	Description
CloneMenu()	Hiermee maakt u een kopie van de huidige MenuItem.
CloneMenu(Menu)	Hiermee kopieert u de Menu parameter die als parameter wordt doorgegeven aan de huidige Menu. (Overgenomen van Menu)
CloneMenu(MenuItem)	Hiermee maakt u een kopie van de opgegeven MenuItem.
CreateMenuHandle()	Hiermee maakt u een nieuwe ingang voor de Menu. (Overgenomen van Menu)
CreateObjRef(Type)	Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject)
Dispose()	Alle resources die worden gebruikt door de Component. (Overgenomen van Component)
Dispose(Boolean)	Verwijdert de resources (behalve het geheugen) die worden gebruikt door de MenuItem.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindMenuItem(Int32, IntPtr)	Hiermee haalt u de MenuItem waarde op die de opgegeven waarde bevat. (Overgenomen van Menu)
FindMergePosition(Int32)	Hiermee wordt de positie geretourneerd waarop een menu-item in het menu moet worden ingevoegd. (Overgenomen van Menu)
GetContextMenu()	Hiermee haalt u het ContextMenu menu op dat dit menu bevat. (Overgenomen van Menu)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetLifetimeService()	Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject)
GetMainMenu()	Hiermee haalt u het MainMenu menu op dat dit menu bevat. (Overgenomen van Menu)
GetService(Type)	Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container. (Overgenomen van Component)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
InitializeLifetimeService()	Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MemberwiseClone(Boolean)	Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject)
MergeMenu()	Hiermee wordt dit MenuItem samengevoegd met een andere MenuItem en wordt het resulterende samengevoegde MenuItemresultaat geretourneerd.
MergeMenu(Menu)	Hiermee worden de MenuItem objecten van één menu samengevoegd met het huidige menu. (Overgenomen van Menu)
MergeMenu(MenuItem)	Hiermee wordt een ander menu-item samengevoegd met dit menu-item.
OnClick(EventArgs)	Hiermee wordt de Click gebeurtenis gegenereerd.
OnDrawItem(DrawItemEventArgs)	Hiermee wordt de DrawItem gebeurtenis gegenereerd.
OnInitMenuPopup(EventArgs)	Hiermee wordt de Popup gebeurtenis gegenereerd.
OnMeasureItem(MeasureItemEventArgs)	Hiermee wordt de MeasureItem gebeurtenis gegenereerd.
OnPopup(EventArgs)	Hiermee wordt de Popup gebeurtenis gegenereerd.
OnSelect(EventArgs)	Hiermee wordt de Select gebeurtenis gegenereerd.
PerformClick()	Hiermee wordt een Click gebeurtenis voor de MenuItemgebeurtenis gegenereerd, waarbij een klik door een gebruiker wordt gesimeerd.
PerformSelect()	Hiermee wordt de Select gebeurtenis voor dit menu-item gegenereerd.
ProcessCmdKey(Message, Keys)	Hiermee wordt een opdrachtsleutel verwerkt. (Overgenomen van Menu)
ToString()	Retourneert een tekenreeks die de MenuItemwaarde vertegenwoordigt.

gebeurtenis

Name	Description
Click	Treedt op wanneer op het menu-item wordt geklikt of geselecteerd met behulp van een sneltoets of toegangssleutel die is gedefinieerd voor het menu-item.
Disposed	Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode. (Overgenomen van Component)
DrawItem	Treedt op wanneer de OwnerDraw eigenschap van een menu-item is ingesteld `true` op en een aanvraag wordt gedaan om het menu-item te tekenen.
MeasureItem	Treedt op wanneer het menu de grootte van een menu-item moet weten voordat u het tekent.
Popup	Vindt plaats voordat de lijst met menu-items van een menu-item wordt weergegeven.
Select	Treedt op wanneer de gebruiker de aanwijzer op een menu-item plaatst.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?