Menu Menu Menu Menu Class

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

L'esempio di codice seguente usa 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. L'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 del carattere e aggiunge quindi due voci di sottomenu alla voce di menu che rappresentano le scelte di piccole e grandi dimensioni del carattere 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. L'esempio richiede che sia presente una 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 è la classe base per il MainMenu, MenuItem, e ContextMenu classi.This class is the base class for the MainMenu, MenuItem, and ContextMenu classes. È possibile creare un'istanza di questa classe.You cannot create an instance of this class. I menu per un'applicazione sono costituiti da MenuItem oggetti.The menus for an application consist of MenuItem objects. Questi possono contenere altri MenuItem oggetti, che rappresentano voci di sottomenu.These can contain other MenuItem objects, representing submenu items. Il MenuItem gli oggetti possono essere archiviati in un MainMenu per la visualizzazione come un'intera struttura di menu per un form o un ContextMenu che consente di 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 per tutte le classi di menu.This class provides functionality that is common for all the menu classes.

A differenza di molte classi di base, il Menu classe utilizza 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 utilizza il menu in un'applicazione di interfaccia a documenti multipli (MDI), è possibile usare la MdiListItem proprietà per specificare un MenuItem che visualizza un elenco di form figli 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. Il MenuItems proprietà contiene un elenco di MenuItem gli oggetti archiviati nella classe menu.The MenuItems property contains a list of MenuItem objects stored in the menu class. Per un MainMenu oppure ContextMenu, questa proprietà contiene tutti i MenuItem gli oggetti che vengono visualizzati.For a MainMenu or ContextMenu, this property contains all the MenuItem objects that are displayed. Per un MenuItem, il MenuItems proprietà rappresenta le voci di sottomenu associate.For a MenuItem, the MenuItems property represents the submenu items associated with it.

Oltre alle proprietà che vengono fornite per tutte le classi derivate di menu, il Menu classe fornisce inoltre metodi, ad esempio CloneMenu e MergeMenu, che consentono di creare nuovi menu dal menu esistenti e anche unire due strutture di menu insieme.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.

Il Menu classe definisce anche la classe annidata Menu.MenuItemCollection.The Menu class also defines the nested class Menu.MenuItemCollection. Questa classe definisce la raccolta di MenuItem gli oggetti utilizzati dal MenuItems proprietà.This class defines the collection of MenuItem objects used by the MenuItems property. È possibile usare i metodi del Menu.MenuItemCollection classe per aggiungere e rimuovere le voci di menu da un MainMenu, ContextMenu, o 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[]) Menu(MenuItem[]) Menu(MenuItem[]) Menu(MenuItem[])

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

Campi

FindHandle FindHandle FindHandle 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 FindShortcut FindShortcut 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 CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
Handle Handle Handle Handle

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

IsParent IsParent IsParent 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 MdiListItem MdiListItem 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 MenuItems MenuItems 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 Name Name Name

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

Site Site Site Site

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

(Inherited from Component)
Tag Tag Tag Tag

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

Metodi

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

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Elimina le risorse, diverse dalla memoria, usate da Menu.Disposes of the resources, other than memory, used by the Menu.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr)

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

FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32) 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() GetContextMenu() GetContextMenu() GetContextMenu()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetMainMenu() GetMainMenu() GetMainMenu() GetMainMenu()

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

GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu) 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) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys)

Elabora un tasto di comando.Processes a command key.

ToString() ToString() ToString() ToString()

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

Eventi

Disposed Disposed Disposed 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.

(Inherited from Component)

Si applica a

Vedi anche