Menu Classe

Definizione

Rappresenta la funzionalità di base per tutti i menu.Represents the base functionality for all menus. Sebbene gli oggetti ToolStripDropDown e ToolStripDropDownMenu sostituiscano il controllo Menu delle versioni precedenti e aggiungano funzionalità rispetto a tale controllo, Menu può essere mantenuto per compatibilità con versioni precedenti e per un utilizzo futuro.Although ToolStripDropDown and ToolStripDropDownMenu replace and add functionality to the Menu control of previous versions, Menu is retained for both backward compatibility and future use if you choose.

public ref class Menu abstract : System::ComponentModel::Component
[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component
type Menu = class
    inherit Component
Public MustInherit Class Menu
Inherits Component
Ereditarietà
Derivato
Attributi

Esempi

Nell'esempio di codice seguente viene utilizzata la classe derivata, MenuItem, per creare una struttura di menu per un form.The following code example uses the derived class, MenuItem, to create a menu structure for a form. Nel codice di esempio viene aggiunto un 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 oggetto MainMenu denominato mainMenu1 e quattro MenuItem oggetti denominati menuItem1, menuItem2, menuItem3e 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 è la classe base per le classi MainMenu, MenuIteme ContextMenu.This class is the base class for the MainMenu, MenuItem, and ContextMenu classes. Non è possibile creare un'istanza di questa classe.You cannot create an instance of this class. I menu di un'applicazione sono costituiti da oggetti MenuItem.The menus for an application consist of MenuItem objects. Possono contenere altri oggetti MenuItem, che rappresentano le voci di sottomenu.These can contain other MenuItem objects, representing submenu items. Gli oggetti MenuItem possono essere archiviati in un MainMenu per la visualizzazione come intera struttura di menu per un form o un ContextMenu utilizzato per visualizzare i menu di scelta rapida.The MenuItem objects can be stored in a MainMenu for display as an entire menu structure for a form or a ContextMenu that is used to display shortcut menus. Questa classe fornisce funzionalità comuni a tutte le classi di menu.This class provides functionality that is common for all the menu classes.

A differenza di molte classi di base, la classe Menu usa le classi derivate per definire molte delle relative proprietà.Unlike many base classes, the Menu class uses its derived classes to define many of its properties. Se si usa il menu in un'applicazione con interfaccia a documenti multipli (MDI), è possibile usare la proprietà MdiListItem per specificare una MenuItem che visualizza un elenco di form figlio MDI aperti nell'applicazione.If you are using your menu in a multiple-document interface (MDI) application, you can use the MdiListItem property to specify a MenuItem that displays a list of open MDI child forms in your application. La proprietà MenuItems contiene un elenco di oggetti MenuItem archiviati nella classe di menu.The MenuItems property contains a list of MenuItem objects stored in the menu class. Per un MainMenu o ContextMenu, questa proprietà contiene tutti gli oggetti MenuItem visualizzati.For a MainMenu or ContextMenu, this property contains all the MenuItem objects that are displayed. Per un MenuItem, la proprietà MenuItems rappresenta le voci di sottomenu associate.For a MenuItem, the MenuItems property represents the submenu items associated with it.

Oltre alle proprietà fornite per tutte le classi di menu derivate, la classe Menu fornisce anche metodi, ad esempio CloneMenu e MergeMenu, che consentono di creare nuovi menu da menu esistenti e di unire due strutture di menu tra loro.In addition to the properties that are provided for all the derived menu classes, the Menu class also provides methods, such as CloneMenu and MergeMenu, that enable you to create new menus from existing menus, and also merge two menu structures together.

La classe Menu definisce anche la classe annidata Menu.MenuItemCollection.The Menu class also defines the nested class Menu.MenuItemCollection. Questa classe definisce la raccolta di oggetti MenuItem utilizzati dalla proprietà MenuItems.This class defines the collection of MenuItem objects used by the MenuItems property. È possibile utilizzare i metodi della classe Menu.MenuItemCollection per aggiungere e rimuovere voci di menu da un MainMenu, ContextMenuo MenuItem.You can use the methods of the Menu.MenuItemCollection class to add and remove menu items from a MainMenu, ContextMenu, or MenuItem.

Costruttori

Menu(MenuItem[])

Inizializza una nuova istanza della classe Menu.Initializes a new instance of the Menu class.

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.

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.

Proprietà

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)
Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
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)
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.

IsParent

Ottiene un valore che indica se questo menu contiene voci di menu.Gets a value indicating whether this menu contains any menu items. Questa proprietà è di sola lettura.This property is read-only.

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.

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.

Name

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

Site

Ottiene o imposta l'oggetto ISite dell'oggetto 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.

Metodi

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.

CreateMenuHandle()

Crea un nuovo handle per l'oggetto Menu.Creates a new handle to the 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 da Menu.Disposes of the resources, other than memory, used by the Menu.

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.

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.

GetContextMenu()

Ottiene l'oggetto ContextMenu che contiene questo menu.Gets the ContextMenu that contains this 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.

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(Menu)

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

ProcessCmdKey(Message, Keys)

Elabora un tasto di comando.Processes a command key.

ToString()

Restituisce una stringa String che rappresenta il controllo Menu.Returns a String that represents the Menu control.

Eventi

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)

Si applica a

Vedi anche