Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe MenuItem

 

Data di pubblicazione: novembre 2016

Rappresenta una singola voce visualizzata all'interno di un MainMenu o ContextMenu. Sebbene ToolStripMenuItem sostituisce e aggiunge funzionalità per il MenuItem controllo delle versioni precedenti, MenuItem viene mantenuto per compatibilità con le versioni precedenti e per uso futuro, se si sceglie.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Menu
        System.Windows.Forms.MenuItem

public class MenuItem : Menu

NomeDescrizione
System_CAPS_pubmethodMenuItem()

Inizializza un MenuItem con una didascalia vuota.

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

Inizializza una nuova istanza della MenuItem classe con una didascalia specificata, i gestori eventi definiti per il Click, Select e Popup gli eventi, un tasto di scelta rapida, un tipo di unione e l'ordine specificato per la voce di menu.

System_CAPS_pubmethodMenuItem(String)

Inizializza una nuova istanza di MenuItem classe con una didascalia specificata per la voce di menu.

System_CAPS_pubmethodMenuItem(String, EventHandler)

Inizializza una nuova istanza della classe con una didascalia e il gestore eventi specificata per il Click evento della voce di menu.

System_CAPS_pubmethodMenuItem(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.

System_CAPS_pubmethodMenuItem(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.

NomeDescrizione
System_CAPS_pubpropertyBarBreak

Ottiene o imposta un valore che indica se il MenuItem viene inserito in una nuova riga (per una voce di menu aggiunta a un MainMenu oggetto) o in una nuova colonna (per una voce di sottomenu o voce di menu visualizzate un ContextMenu).

System_CAPS_pubpropertyBreak

Ottiene o imposta un valore che indica se l'elemento viene collocato in una nuova riga (per una voce di menu aggiunta a un MainMenu oggetto) o in una nuova colonna (per una voce di menu o di sottomenu visualizzata in un ContextMenu).

System_CAPS_protpropertyCanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.(Ereditato da Component.)

System_CAPS_pubpropertyChecked

Ottiene o imposta un valore che indica se viene visualizzato un segno di spunta accanto al testo della voce di menu.

System_CAPS_pubpropertyContainer

Ottiene il IContainer che contiene il Component.(Ereditato da Component.)

System_CAPS_pubpropertyDefaultItem

Ottiene o imposta un valore che indica se la voce di menu è quella predefinita.

System_CAPS_protpropertyDesignMode

Ottiene un valore che indica se il Component è attualmente in modalità progettazione.(Ereditato da Component.)

System_CAPS_pubpropertyEnabled

Ottiene o imposta un valore che indica se la voce di menu è abilitata.

System_CAPS_protpropertyEvents

Ottiene l'elenco di gestori eventi associati a questo Component.(Ereditato da Component.)

System_CAPS_pubpropertyHandle

Ottiene un valore che rappresenta l'handle di finestra per il menu.(Ereditato da Menu.)

System_CAPS_pubpropertyIndex

Ottiene o imposta un valore che indica la posizione della voce di menu nel menu padre corrispondente.

System_CAPS_pubpropertyIsParent

Ottiene un valore che indica se la voce di menu contiene voci di menu figlie.(Esegue l'override di Menu.IsParent.)

System_CAPS_pubpropertyMdiList

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.

System_CAPS_pubpropertyMdiListItem

Ottiene un valore che indica il MenuItem che viene utilizzato per visualizzare un elenco di form figlio di multiple document interface (MDI).(Ereditato da Menu.)

System_CAPS_protpropertyMenuID

Ottiene un valore che indica l'identificatore Windows per questa voce di menu.

System_CAPS_pubpropertyMenuItems

Ottiene un valore che indica la raccolta di MenuItem oggetti associati con il menu.(Ereditato da Menu.)

System_CAPS_pubpropertyMergeOrder

Ottiene o imposta un valore che indica la posizione relativa della voce di menu quando è unito a un altro.

System_CAPS_pubpropertyMergeType

Ottiene o imposta un valore che indica il comportamento di questa voce di menu quando il relativo menu è unito a un altro.

System_CAPS_pubpropertyMnemonic

Ottiene un valore che indica il carattere mnemonico associato a questa voce di menu.

System_CAPS_pubpropertyName

Ottiene o imposta il nome di Menu.(Ereditato da Menu.)

System_CAPS_pubpropertyOwnerDraw

Ottiene o imposta un valore che indica se è il codice fornito oppure Windows a disegnare la voce di menu.

System_CAPS_pubpropertyParent

Ottiene un valore che indica il menu che contiene questa voce di menu.

System_CAPS_pubpropertyRadioCheck

Ottiene o imposta un valore che indica se il MenuItem, se selezionata, viene visualizzato un pulsante di opzione anziché un segno di spunta.

System_CAPS_pubpropertyShortcut

Ottiene o imposta un valore che indica il tasto di scelta rapida associato alla voce di menu.

System_CAPS_pubpropertyShowShortcut

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.

System_CAPS_pubpropertySite

Ottiene o imposta il ISite di Component.(Ereditato da Component.)

System_CAPS_pubpropertyTag

Ottiene o imposta dati definiti dall'utente associati al controllo.(Ereditato da Menu.)

System_CAPS_pubpropertyText

Ottiene o imposta un valore che indica la didascalia della voce di menu.

System_CAPS_pubpropertyVisible

Ottiene o imposta un valore che indica se la voce di menu è visibile.

NomeDescrizione
System_CAPS_pubmethodCloneMenu()

Crea una copia dell'oggetto MenuItem corrente.

System_CAPS_protmethodCloneMenu(Menu)

Copie di Menu che viene passato come parametro al corrente Menu.(Ereditato da Menu.)

System_CAPS_protmethodCloneMenu(MenuItem)

Crea una copia dell'oggetto specificato MenuItem.

System_CAPS_protmethodCreateMenuHandle()

Crea un nuovo handle per il Menu.(Ereditato da Menu.)

System_CAPS_pubmethodCreateObjRef(Type)

Crea un oggetto che contiene le informazioni necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Rilascia tutte le risorse usate da Component.(Ereditato da Component.)

System_CAPS_protmethodDispose(Boolean)

Elimina le risorse, diverse dalla memoria, usate dall'oggetto MenuItem.(Esegue l'override di Menu.Dispose(Boolean).)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Rilascia risorse non gestite ed esegue altre operazioni di pulizia prima che la classe Component venga recuperata tramite Garbage Collection.(Ereditato da Component.)

System_CAPS_pubmethodFindMenuItem(Int32, IntPtr)

Ottiene il MenuItem che contiene il valore specificato.(Ereditato da Menu.)

System_CAPS_protmethodFindMergePosition(Int32)

Restituisce la posizione in cui deve essere inserita una voce di menu nel menu.(Ereditato da Menu.)

System_CAPS_pubmethodGetContextMenu()

Ottiene il ContextMenu che contiene questo menu.(Ereditato da Menu.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodGetMainMenu()

Ottiene il MainMenu che contiene questo menu.(Ereditato da Menu.)

System_CAPS_protmethodGetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.(Ereditato da Component.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject oggetto.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodMergeMenu()

Unisce questo MenuItem con un'altra MenuItem e restituisce l'oggetto risultante unita MenuItem.

System_CAPS_pubmethodMergeMenu(Menu)

Unisce il MenuItem gli oggetti di un menu con menu corrente.(Ereditato da Menu.)

System_CAPS_pubmethodMergeMenu(MenuItem)

Unisce un'altra voce di menu a questa.

System_CAPS_protmethodOnClick(EventArgs)

Genera l'evento Click.

System_CAPS_protmethodOnDrawItem(DrawItemEventArgs)

Genera l'evento DrawItem.

System_CAPS_protmethodOnInitMenuPopup(EventArgs)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Genera l'evento Popup.

System_CAPS_protmethodOnMeasureItem(MeasureItemEventArgs)

Genera l'evento MeasureItem.

System_CAPS_protmethodOnPopup(EventArgs)

Genera l'evento Popup.

System_CAPS_protmethodOnSelect(EventArgs)

Genera l'evento Select.

System_CAPS_pubmethodPerformClick()

Genera una Click evento per il MenuItem, simulando il clic da un utente.

System_CAPS_pubmethodPerformSelect()

Genera il Select evento per questa voce di menu.

System_CAPS_protmethodProcessCmdKey(Message, Keys)

Elabora un tasto di comando.(Ereditato da Menu.)

System_CAPS_pubmethodToString()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Restituisce una stringa che rappresenta il MenuItem.(Esegue l'override di Menu.ToString().)

NomeDescrizione
System_CAPS_pubeventClick

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.

System_CAPS_pubeventDisposed

Si verifica quando il componente viene eliminato da una chiamata al Dispose metodo.(Ereditato da Component.)

System_CAPS_pubeventDrawItem

Si verifica quando il OwnerDraw una voce di menu è impostata su true e viene effettuata una richiesta per disegnare la voce di menu.

System_CAPS_pubeventMeasureItem

Si verifica quando il menu deve conoscere la dimensione di una voce di menu prima di disegnarla.

System_CAPS_pubeventPopup

Si verifica prima della visualizzazione dell'elenco delle voci di menu.

System_CAPS_pubeventSelect

Si verifica quando l'utente posiziona il puntatore su una voce di menu.

Affinché un MenuItem per essere visualizzato, è necessario aggiungerlo a un MainMenu o ContextMenu. Per creare sottomenu, è possibile aggiungere MenuItem oggetti per la MenuItems proprietà dell'elemento padre MenuItem.

La MenuItem classe fornisce le proprietà che consentono di configurare l'aspetto e funzionalità di una voce di menu. Per visualizzare un segno di spunta accanto a una voce di menu, utilizzare il Checked proprietà. È possibile utilizzare questa funzionalità per identificare una voce di menu selezionata in un elenco di voci di menu si escludono a vicenda. Ad esempio, se si dispone di un set di voci di menu per l'impostazione del colore del testo in un TextBox controllo, è possibile utilizzare il Checked proprietà per identificare il colore attualmente selezionato. Il Shortcut proprietà può essere utilizzata per definire una combinazione di tasti da premere per selezionare la voce di menu.

Per MenuItem gli oggetti visualizzati in un'applicazione Multiple Document Interface (MDI), è possibile utilizzare il MergeMenu metodo per unire i menu di un form MDI padre con quelli dei relativi form figli per creare una struttura di menu consolidato. Poiché un MenuItem non può essere riutilizzato in più posizioni contemporaneamente, ad esempio un MainMenu e ContextMenu, è possibile utilizzare il CloneMenu metodo per creare una copia di un MenuItem per l'utilizzo in un'altra posizione.

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

Esempio di codice seguente crea una struttura di menu per un form. Nell'esempio di codice aggiunge un MenuItem per rappresentare la voce di menu di primo livello, aggiunge una voce di sottomenu per la selezione di una dimensione e quindi aggiunge due voci di sottomenu alla voce di menu che rappresentano le scelte di piccole e grandi dimensioni del carattere in un'applicazione. L'esempio richiede che vi sia un MainMenu oggetto denominato mainMenu1 e quattro MenuItem oggetti denominati menuItem1, menuItem2, menuItem3, e 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);
    }

.NET Framework
Disponibile da 1.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: