Menu Classe

Definizione

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

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

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public abstract class Menu : System.ComponentModel.Component

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

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
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 BrowsableAttribute ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene utilizzata la classe derivata , MenuItem, per creare una struttura di menu per un modulo. Il codice di esempio aggiunge un oggetto MenuItem per rappresentare la voce di menu di primo livello, aggiunge una voce di sottomenu per la selezione di una dimensione del carattere e quindi aggiunge due voci di sottomenu a tale voce di menu che rappresentano scelte di tipo carattere grandi e piccole in un'applicazione. L'esempio richiede che sia presente un oggetto denominato mainMenu1 e quattro MenuItem oggetti denominati menuItem1, menuItem2menuItem3, e menuItem4.MainMenu

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 . Possono contenere altri MenuItem oggetti, che rappresentano gli elementi del sottomenu. Gli MenuItem oggetti possono essere archiviati in un MainMenu oggetto per la visualizzazione come struttura di menu intera per una maschera 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 classi derivate per definire molte delle relative proprietà. Se si usa il menu in un'applicazione MDI (Multiple-Document Interface), è possibile utilizzare la MdiListItem proprietà per specificare un MenuItem oggetto che visualizza un 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 un MenuItemoggetto , la MenuItems proprietà rappresenta gli elementi del 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 di unire due strutture di menu insieme.

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

Vedi anche

• MainMenu
• ContextMenu
• MenuItem