MenuItem Classe

Definizione

Rappresenta una singola voce visualizzata all'interno di un oggetto MainMenu o ContextMenu.Represents an individual item that is displayed within a MainMenu or ContextMenu.

Questa classe non è disponibile in .NET Core 3,1 e versioni successive.This class is not available in .NET Core 3.1 and later versions. In ToolStripMenuItem alternativa, usare, che sostituisce il MenuItem controllo.Use ToolStripMenuItem instead, which replaces the MenuItem control.

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
Ereditarietà

Esempio

Nell'esempio di codice seguente viene creata una struttura di menu per un form.The following code example creates a menu structure for a form. Nel codice di esempio viene aggiunto un oggetto MenuItem per rappresentare la voce di menu di primo livello, viene aggiunta una voce di sottomenu per la selezione di una dimensione del carattere, quindi vengono aggiunte due voci di sottomenu a tale voce di menu che rappresentano le scelte dei tipi di carattere grandi e piccoli in un'applicazione.The example code adds a MenuItem to represent the top-level menu item, adds a submenu item to it for selecting a font size, and then adds two submenu items to that menu item that represent large and small font choices in an application. Per l'esempio è necessario che esista un MainMenu oggetto denominato mainMenu1 e quattro MenuItem oggetti denominati,, menuItem1 menuItem2 menuItem3 e menuItem4 .The example requires that there is a MainMenu object named mainMenu1 and four MenuItem objects named menuItem1, menuItem2, menuItem3, and 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

Commenti

Questa classe non è disponibile in .NET Core 3,1 e versioni successive.This class is not available in .NET Core 3.1 and later versions. Usare invece .Use instead.

Per consentire la MenuItem visualizzazione di un oggetto, è necessario aggiungerlo a un oggetto MainMenu o ContextMenu .In order for a MenuItem to be displayed, you must add it to a MainMenu or ContextMenu. Per creare sottomenu, è possibile aggiungere MenuItem oggetti alla MenuItems proprietà dell'elemento padre MenuItem .To create submenus, you can add MenuItem objects to the MenuItems property of the parent MenuItem.

La MenuItem classe fornisce proprietà che consentono di configurare l'aspetto e la funzionalità di una voce di menu.The MenuItem class provides properties that enable you to configure the appearance and functionality of a menu item. Per visualizzare un segno di spunta accanto a una voce di menu, usare la Checked Proprietà.To display a check mark next to a menu item, use the Checked property. È possibile usare questa funzionalità per identificare una voce di menu selezionata in un elenco di voci di menu che si escludono a vicenda.You can use this feature to identify a menu item that is selected in a list of mutually exclusive menu items. Se, ad esempio, si dispone di un set di voci di menu per l'impostazione del colore del testo in un TextBox controllo, è possibile usare la Checked proprietà per identificare il colore attualmente selezionato.For example, if you have a set of menu items for setting the color of text in a TextBox control, you can use the Checked property to identify which color is currently selected. La Shortcut proprietà può essere utilizzata per definire una combinazione di tasti che è possibile premere per selezionare la voce di menu.The Shortcut property can be used to define a keyboard combination that can be pressed to select the menu item.

Per MenuItem gli oggetti visualizzati in un'applicazione con interfaccia a documenti multipli (MDI), è possibile usare il MergeMenu metodo per unire i menu di un elemento padre MDI per con quello dei form figlio per creare una struttura di menu consolidato.For MenuItem objects displayed in a Multiple Document Interface (MDI) application, you can use the MergeMenu method to merge the menus of an MDI parent for with that of its child forms to create a consolidated menu structure. Poiché un oggetto MenuItem non può essere riutilizzato in più posizioni contemporaneamente, ad esempio in un oggetto MainMenu e un oggetto ContextMenu , è possibile utilizzare il CloneMenu metodo per creare una copia di un oggetto MenuItem da utilizzare in un altro percorso.Because a MenuItem cannot be reused in multiple locations at the same time, such as in a MainMenu and a ContextMenu, you can use the CloneMenu method to create a copy of a MenuItem for use in another location.

L' Popup evento consente di eseguire attività prima che venga visualizzato un menu.The Popup event enables you to perform tasks before a menu is displayed. È ad esempio possibile creare un gestore eventi per questo evento per visualizzare o nascondere le voci di menu in base allo stato del codice.For example, you can create an event handler for this event to display or hide menu items based on the state of your code. L' Select evento consente di eseguire attività come la fornitura di una guida dettagliata per le voci di menu dell'applicazione quando l'utente posiziona il puntatore del mouse su una voce di menu.The Select event enables you to perform tasks such as providing detailed help for your application's menu items when the user places the mouse pointer over a menu item.

Costruttori

MenuItem()

Inizializza un oggetto MenuItem con una didascalia vuota.Initializes a MenuItem with a blank caption.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inizializza una nuova istanza della classe MenuItem con una didascalia specifica, gestori eventi definiti per gli eventi Click, Select e Popup, un tasto di scelta rapida, un tipo di unione e un ordine specificati per la voce di menu.Initializes a new instance of the MenuItem class with a specified caption; defined event-handlers for the Click, Select and Popup events; a shortcut key; a merge type; and order specified for the menu item.

MenuItem(String)

Inizializza una nuova istanza della classe MenuItem con una didascalia specificata per la voce di menu.Initializes a new instance of the MenuItem class with a specified caption for the menu item.

MenuItem(String, EventHandler)

Inizializza una nuova istanza della classe con una didascalia specificata e un gestore eventi per l'evento Click della voce di menu.Initializes a new instance of the class with a specified caption and event handler for the Click event of the menu item.

MenuItem(String, EventHandler, Shortcut)

Inizializza una nuova istanza della classe con una didascalia specificata, un gestore eventi e il tasto di scelta rapida per la voce di menu.Initializes a new instance of the class with a specified caption, event handler, and associated shortcut key for the menu item.

MenuItem(String, MenuItem[])

Inizializza una nuova istanza della classe con una didascalia specificata e una matrice di voci di sottomenu definita per la voce di menu.Initializes a new instance of the class with a specified caption and an array of submenu items defined for the menu item.

Campi

FindHandle

Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un handle.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Ereditato da Menu)
FindShortcut

Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un collegamento.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Ereditato da Menu)

Proprietà

BarBreak

Ottiene o imposta un valore che indica se l'oggetto MenuItem è collocato su una nuova riga, nel caso di una voce di menu aggiunta a un oggetto MainMenu, o in una nuova colonna, nel caso di una voce di menu o di sottomenu visualizzata in un oggetto ContextMenu.Gets or sets a value indicating whether the MenuItem is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a submenu item or menu item displayed in a ContextMenu).

Break

Ottiene o imposta un valore che indica se l'elemento è collocato su una nuova riga, nel caso di una voce di menu aggiunta a un oggetto MainMenu, o in una nuova colonna, nel caso di una voce di menu o di sottomenu visualizzata in un oggetto ContextMenu.Gets or sets a value indicating whether the item is placed on a new line (for a menu item added to a MainMenu object) or in a new column (for a menu item or submenu item displayed in a ContextMenu).

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Checked

Ottiene o imposta un valore che indica se viene visualizzato un segno di spunta accanto al testo della voce di menu.Gets or sets a value indicating whether a check mark appears next to the text of the menu item.

Container

Ottiene l'oggetto IContainer che contiene Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DefaultItem

Ottiene o imposta un valore che indica se la voce di menu è quella predefinita.Gets or sets a value indicating whether the menu item is the default menu item.

DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Enabled

Ottiene o imposta un valore che indica se la voce di menu è abilitata.Gets or sets a value indicating whether the menu item is enabled.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
Handle

Ottiene un valore che rappresenta l'handle della finestra per il menu.Gets a value representing the window handle for the menu.

(Ereditato da Menu)
Index

Ottiene o imposta un valore che indica la posizione della voce di menu nel menu padre corrispondente.Gets or sets a value indicating the position of the menu item in its parent menu.

IsParent

Ottiene un valore che indica se la voce di menu contiene voci di menu figlie.Gets a value indicating whether the menu item contains child menu items.

MdiList

Ottiene o imposta un valore che indica se la voce di menu sarà compilata con un elenco di finestre figlie Multiple Document Interface (MDI) visualizzate nel form associato.Gets or sets a value indicating whether the menu item will be populated with a list of the Multiple Document Interface (MDI) child windows that are displayed within the associated form.

MdiListItem

Ottiene un valore che indica l'oggetto MenuItem utilizzato per visualizzare un elenco di form figlio Multiple Document Interface (MDI).Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Ereditato da Menu)
MenuID

Ottiene un valore che indica l'identificatore Windows per questa voce di menu.Gets a value indicating the Windows identifier for this menu item.

MenuItems

Ottiene un valore che indica l'insieme degli oggetti MenuItem associato al menu.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Ereditato da Menu)
MergeOrder

Ottiene o imposta un valore che indica la posizione relativa della voce di menu quando è unito a un altro.Gets or sets a value indicating the relative position of the menu item when it is merged with another.

MergeType

Ottiene o imposta un valore che indica il comportamento di questa voce di menu quando il relativo menu è unito a un altro.Gets or sets a value indicating the behavior of this menu item when its menu is merged with another.

Mnemonic

Ottiene un valore che indica il carattere mnemonico associato a questa voce di menu.Gets a value indicating the mnemonic character that is associated with this menu item.

Name

Ottiene o imposta il nome di Menu.Gets or sets the name of the Menu.

(Ereditato da Menu)
OwnerDraw

Ottiene o imposta un valore che indica se è il codice fornito oppure Windows a disegnare la voce di menu.Gets or sets a value indicating whether the code that you provide draws the menu item or Windows draws the menu item.

Parent

Ottiene un valore che indica il menu che contiene questa voce di menu.Gets a value indicating the menu that contains this menu item.

RadioCheck

Ottiene o imposta un valore che indica se l'oggetto MenuItem, quando selezionato, visualizza un pulsante di opzione anziché un segno di spunta.Gets or sets a value indicating whether the MenuItem, if checked, displays a radio-button instead of a check mark.

Shortcut

Ottiene o imposta un valore che indica il tasto di scelta rapida associato alla voce di menu.Gets or sets a value indicating the shortcut key associated with the menu item.

ShowShortcut

Ottiene o imposta un valore che indica se il tasto di scelta rapida associato alla voce di menu viene visualizzato accanto alla didascalia della voce di menu.Gets or sets a value indicating whether the shortcut key that is associated with the menu item is displayed next to the menu item caption.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Tag

Ottiene o imposta dati definiti dall'utente associati al controllo.Gets or sets user-defined data associated with the control.

(Ereditato da Menu)
Text

Ottiene o imposta un valore che indica la didascalia della voce di menu.Gets or sets a value indicating the caption of the menu item.

Visible

Ottiene o imposta un valore che indica se la voce di menu è visibile.Gets or sets a value indicating whether the menu item is visible.

Metodi

CloneMenu()

Crea una copia dell'oggetto MenuItem corrente.Creates a copy of the current MenuItem.

CloneMenu(Menu)

Copia l'oggetto Menu passato come parametro all'oggetto Menu corrente.Copies the Menu that is passed as a parameter to the current Menu.

(Ereditato da Menu)
CloneMenu(MenuItem)

Crea una copia dell'oggetto MenuItem specificato.Creates a copy of the specified MenuItem.

CreateMenuHandle()

Crea un nuovo handle per l'oggetto Menu.Creates a new handle to the Menu.

(Ereditato da Menu)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Elimina le risorse, diverse dalla memoria, usate dall'oggetto MenuItem.Disposes of the resources (other than memory) used by the MenuItem.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FindMenuItem(Int32, IntPtr)

Ottiene l'oggetto MenuItem che contiene il valore specificato.Gets the MenuItem that contains the value specified.

(Ereditato da Menu)
FindMergePosition(Int32)

Restituisce la posizione in cui dovrebbe essere inserita una voce all'interno del menu.Returns the position at which a menu item should be inserted into the menu.

(Ereditato da Menu)
GetContextMenu()

Ottiene l'oggetto ContextMenu che contiene questo menu.Gets the ContextMenu that contains this menu.

(Ereditato da Menu)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetMainMenu()

Ottiene l'oggetto MainMenu che contiene questo menu.Gets the MainMenu that contains this menu.

(Ereditato da Menu)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
MergeMenu()

Unisce questo oggetto MenuItem a un altro MenuItem e restituisce l'oggetto MenuItem unito risultante.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(Menu)

Unisce gli oggetti MenuItem di un menu con il menu corrente.Merges the MenuItem objects of one menu with the current menu.

(Ereditato da Menu)
MergeMenu(MenuItem)

Unisce un'altra voce di menu a questa.Merges another menu item with this menu item.

OnClick(EventArgs)

Genera l'evento Click.Raises the Click event.

OnDrawItem(DrawItemEventArgs)

Genera l'evento DrawItem.Raises the DrawItem event.

OnInitMenuPopup(EventArgs)

Genera l'evento Popup.Raises the Popup event.

OnMeasureItem(MeasureItemEventArgs)

Genera l'evento MeasureItem.Raises the MeasureItem event.

OnPopup(EventArgs)

Genera l'evento Popup.Raises the Popup event.

OnSelect(EventArgs)

Genera l'evento Select.Raises the Select event.

PerformClick()

Genera un evento Click per l'oggetto MenuItem, simulando il clic dell’utente.Generates a Click event for the MenuItem, simulating a click by a user.

PerformSelect()

Genera l'evento Select per questa voce di menu.Raises the Select event for this menu item.

ProcessCmdKey(Message, Keys)

Elabora un tasto di comando.Processes a command key.

(Ereditato da Menu)
ToString()

Restituisce una stringa che rappresenta l'oggetto MenuItem.Returns a string that represents the MenuItem.

Eventi

Click

Si verifica quando la voce di menu viene selezionata mediante il mouse o mediante un tasto di scelta rapida o di scelta definito per quella voce di menu.Occurs when the menu item is clicked or selected using a shortcut key or access key defined for the menu item.

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)
DrawItem

Viene generato quando la proprietà OwnerDraw di una voce di menu è impostata su true e viene richiesto di disegnare la voce di menu.Occurs when the OwnerDraw property of a menu item is set to true and a request is made to draw the menu item.

MeasureItem

Si verifica quando il menu deve conoscere la dimensione di una voce di menu prima di disegnarla.Occurs when the menu needs to know the size of a menu item before drawing it.

Popup

Si verifica prima della visualizzazione dell'elenco delle voci di menu.Occurs before a menu item's list of menu items is displayed.

Select

Si verifica quando l'utente posiziona il puntatore su una voce di menu.Occurs when the user places the pointer over a menu item.

Si applica a

Vedi anche