Menu 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 la funzionalità di base per tutti i menu.

Questa classe non è disponibile in .NET Core 3.1 e versioni successive. Usare ToolStripDropDown e ToolStripDropDownMenu in alternativa, che sostituiscono ed estendono il controllo Menu.

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Ereditarietà: Object

MarshalByRefObject

Component
Menu

Derivato: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Attributi: ListBindableAttribute

Esempio

Nell'esempio di codice seguente viene usata la classe derivata, , MenuItemper creare 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, usare ToolStripDropDown e ToolStripDropDownMenu.

Questa classe è la classe di base per le MainMenuclassi , MenuIteme ContextMenu . Non è possibile creare un'istanza di questa classe. I menu per un'applicazione sono costituiti da MenuItem oggetti. Questi possono contenere altri MenuItem oggetti, che rappresentano elementi di sottomenu. Gli MenuItem oggetti possono essere archiviati in un MainMenu oggetto per la visualizzazione come un'intera struttura di menu per un modulo o un ContextMenu oggetto utilizzato per visualizzare i menu di scelta rapida. Questa classe fornisce funzionalità comuni per tutte le classi di menu.

A differenza di molte classi di base, la Menu classe usa le relative classi derivate per definire molte delle relative proprietà. Se si usa il menu in un'applicazione MDI (Multiple-Document Interface), è possibile usare la MdiListItem proprietà per specificare un MenuItem elenco di moduli figlio MDI aperti nell'applicazione. La MenuItems proprietà contiene un elenco di MenuItem oggetti archiviati nella classe di menu. Per un MainMenu oggetto o ContextMenu, questa proprietà contiene tutti gli MenuItem oggetti visualizzati. Per , MenuItemla MenuItems proprietà rappresenta gli elementi di sottomenu associati.

Oltre alle proprietà fornite per tutte le classi di menu derivate, la Menu classe fornisce anche metodi, ad esempio CloneMenu e MergeMenu, che consentono di creare nuovi menu dai menu esistenti e anche unire due strutture di menu insieme.

La Menu classe definisce anche la classe Menu.MenuItemCollectionannidata. Questa classe definisce la raccolta di MenuItem oggetti usati dalla MenuItems proprietà . È possibile usare i metodi della Menu.MenuItemCollection classe per aggiungere e rimuovere le voci di menu da un MainMenuoggetto , ContextMenuo MenuItem.

Costruttori

Menu(MenuItem[])

Inizializza una nuova istanza della classe Menu.

Campi

FindHandle	Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un handle.
FindShortcut	Specifica che il metodo FindMenuItem(Int32, IntPtr) deve eseguire la ricerca di un collegamento.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
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.
IsParent	Ottiene un valore che indica se questo menu contiene voci di menu. Questa proprietà è di sola lettura.
MdiListItem	Ottiene un valore che indica l'oggetto MenuItem utilizzato per visualizzare un elenco di form figlio Multiple Document Interface (MDI).
MenuItems	Ottiene un valore che indica l'insieme degli oggetti MenuItem associato al menu.
Name	Ottiene o imposta il nome 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.

Metodi

CloneMenu(Menu)	Copia l'oggetto Menu passato come parametro all'oggetto Menu corrente.
CreateMenuHandle()	Crea un nuovo handle per l'oggetto 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 da Menu.
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.
FindMergePosition(Int32)	Restituisce la posizione in cui dovrebbe essere inserita una voce all'interno del menu.
GetContextMenu()	Ottiene l'oggetto ContextMenu che contiene questo menu.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleta. 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.
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()	Obsoleta. 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(Menu)	Unisce gli oggetti MenuItem di un menu con il menu corrente.
ProcessCmdKey(Message, Keys)	Elabora un tasto di comando.
ToString()	Restituisce una stringa String che rappresenta il controllo Menu.

Eventi

Disposed

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

(Ereditato da Component)

Si applica a