MenuItem Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una singola voce visualizzata all'interno di un oggetto MainMenu o ContextMenu.

Questa classe non è disponibile in .NET Core 3.1 e versioni successive. Usare ToolStripMenuItem invece, che sostituisce il MenuItem controllo.

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à: Object

MarshalByRefObject

Component

Menu
MenuItem

Esempio

Nell'esempio di codice seguente viene creata una struttura di menu per un modulo. Il codice di esempio aggiunge un MenuItem oggetto per rappresentare la voce di menu di primo livello, aggiunge un elemento sottomenu per selezionare una dimensione del carattere e quindi aggiunge due voci di sottomenu a tale voce di menu che rappresentano scelte di tipo carattere di grandi dimensioni e piccole in un'applicazione. L'esempio richiede che sia presente un MainMenu oggetto denominato mainMenu1 e quattro MenuItem oggetti denominati menuItem1, menuItem2, menuItem3e 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. In alternativa, utilizzare ToolStripMenuItem.

Per visualizzare un oggetto MenuItem , è necessario aggiungerlo a o MainMenu ContextMenu. Per creare sottomenus, è possibile aggiungere MenuItem oggetti alla MenuItems proprietà dell'elemento padre MenuItem.

La MenuItem classe fornisce proprietà che consentono di configurare l'aspetto e la funzionalità di una voce di menu. Per visualizzare un segno di spunta accanto a una voce di menu, usare la Checked proprietà . È possibile usare questa funzionalità per identificare una voce di menu selezionata in un elenco di voci di menu reciprocamente esclusive. Ad esempio, se si dispone di un set di voci di menu per impostare il colore del testo in un TextBox controllo, è possibile usare la proprietà per identificare il Checked colore attualmente selezionato. La Shortcut proprietà può essere usata per definire una combinazione di tastiera che può essere premuta per selezionare la voce di menu.

Per MenuItem gli oggetti visualizzati in un'applicazione MDI (Multiple Document Interface), è possibile usare il MergeMenu metodo per unire i menu di un padre MDI per con quello dei moduli figlio per creare una struttura di menu consolidata. Poiché un MenuItem oggetto non può essere riutilizzato in più posizioni contemporaneamente, ad esempio in un e in ContextMenuun , è possibile usare il CloneMenu metodo per creare una copia di un MainMenu MenuItem oggetto per l'uso in un'altra posizione.

L'evento Popup consente di eseguire attività prima che venga visualizzato un menu. Ad esempio, è possibile creare un gestore eventi per questo evento per visualizzare o nascondere le voci di menu in base allo stato del codice. L'evento Select consente di eseguire attività come fornire assistenza dettagliata per le voci di menu dell'applicazione quando l'utente posiziona il puntatore del mouse su una voce di menu.

Costruttori

MenuItem()	Inizializza un oggetto MenuItem con una didascalia vuota.
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.
MenuItem(String)	Inizializza una nuova istanza della classe MenuItem con una didascalia specificata per la voce di menu.
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.
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.
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.

Campi

FindHandle	Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un handle. (Ereditato da Menu)
FindShortcut	Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un collegamento. (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.
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.
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (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.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DefaultItem	Ottiene o imposta un valore che indica se la voce di menu è quella predefinita.
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Enabled	Ottiene o imposta un valore che indica se la voce di menu è abilitata.
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
Handle	Ottiene un valore che rappresenta l'handle della finestra per il menu. (Ereditato da Menu)
Index	Ottiene o imposta un valore che indica la posizione della voce di menu nel menu padre corrispondente.
IsParent	Ottiene un valore che indica se la voce di menu contiene voci di menu figlie.
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.
MdiListItem	Ottiene un valore che indica l'oggetto MenuItem utilizzato per visualizzare un elenco di form figlio Multiple Document Interface (MDI). (Ereditato da Menu)
MenuID	Ottiene un valore che indica l'identificatore Windows per questa voce di menu.
MenuItems	Ottiene un valore che indica l'insieme degli oggetti MenuItem associato al menu. (Ereditato da Menu)
MergeOrder	Ottiene o imposta un valore che indica la posizione relativa della voce di menu quando è unito a un altro.
MergeType	Ottiene o imposta un valore che indica il comportamento di questa voce di menu quando il relativo menu è unito a un altro.
Mnemonic	Ottiene un valore che indica il carattere mnemonico associato a questa voce di menu.
Name	Ottiene o imposta il nome di Menu. (Ereditato da Menu)
OwnerDraw	Ottiene o imposta un valore che indica se è il codice fornito oppure Windows a disegnare la voce di menu.
Parent	Ottiene un valore che indica il menu che contiene questa voce di menu.
RadioCheck	Ottiene o imposta un valore che indica se l'oggetto MenuItem, quando selezionato, visualizza un pulsante di opzione anziché un segno di spunta.
Shortcut	Ottiene o imposta un valore che indica il tasto di scelta rapida associato alla voce di menu.
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.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Tag	Ottiene o imposta dati definiti dall'utente associati al controllo. (Ereditato da Menu)
Text	Ottiene o imposta un valore che indica la didascalia della voce di menu.
Visible	Ottiene o imposta un valore che indica se la voce di menu è visibile.

Metodi

CloneMenu()	Crea una copia dell'oggetto MenuItem corrente.
CloneMenu(Menu)	Copia l'oggetto Menu passato come parametro all'oggetto Menu corrente. (Ereditato da Menu)
CloneMenu(MenuItem)	Crea una copia dell'oggetto MenuItem specificato.
CreateMenuHandle()	Crea un nuovo handle per l'oggetto 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. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Elimina le risorse, diverse dalla memoria, usate dall'oggetto MenuItem.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindMenuItem(Int32, IntPtr)	Ottiene l'oggetto MenuItem che contiene il valore specificato. (Ereditato da Menu)
FindMergePosition(Int32)	Restituisce la posizione in cui dovrebbe essere inserita una voce all'interno del menu. (Ereditato da Menu)
GetContextMenu()	Ottiene l'oggetto ContextMenu che contiene questo menu. (Ereditato da Menu)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetMainMenu()	Ottiene l'oggetto MainMenu che contiene questo menu. (Ereditato da Menu)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
MergeMenu()	Unisce questo oggetto MenuItem a un altro MenuItem e restituisce l'oggetto MenuItem unito risultante.
MergeMenu(Menu)	Unisce gli oggetti MenuItem di un menu con il menu corrente. (Ereditato da Menu)
MergeMenu(MenuItem)	Unisce un'altra voce di menu a questa.
OnClick(EventArgs)	Genera l'evento Click.
OnDrawItem(DrawItemEventArgs)	Genera l'evento DrawItem.
OnInitMenuPopup(EventArgs)	Genera l'evento Popup.
OnMeasureItem(MeasureItemEventArgs)	Genera l'evento MeasureItem.
OnPopup(EventArgs)	Genera l'evento Popup.
OnSelect(EventArgs)	Genera l'evento Select.
PerformClick()	Genera un evento Click per l'oggetto MenuItem, simulando il clic dell’utente.
PerformSelect()	Genera l'evento Select per questa voce di menu.
ProcessCmdKey(Message, Keys)	Elabora un tasto di comando. (Ereditato da Menu)
ToString()	Restituisce una stringa che rappresenta l'oggetto 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.
Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (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.
MeasureItem	Si verifica quando il menu deve conoscere la dimensione di una voce di menu prima di disegnarla.
Popup	Si verifica prima della visualizzazione dell'elenco delle voci di menu.
Select	Si verifica quando l'utente posiziona il puntatore su una voce di menu.

Si applica a