MenuItem Classe

Definizione

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

[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 class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

[<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 MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Ereditarietà

Object

MarshalByRefObject

Component

Menu

MenuItem

Attributi

BrowsableAttribute ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene creata 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. Utilizzare invece ToolStripMenuItem.

Per visualizzare un oggetto MenuItem , è necessario aggiungerlo a un MainMenu oggetto o ContextMenu. Per creare sottomenu, è possibile aggiungere MenuItem oggetti alla MenuItems proprietà dell'oggetto padre MenuItem.

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

Per MenuItem gli oggetti visualizzati in un'applicazione MDI (Multiple Document Interface), è possibile utilizzare il MergeMenu metodo per unire i menu di un padre MDI per con quello dei relativi moduli figlio per creare una struttura di menu consolidata. Poiché un oggetto MenuItem non può essere riutilizzato in più posizioni contemporaneamente, ad esempio in e MainMenu in un ContextMenuoggetto , è possibile usare il CloneMenu metodo per creare una copia di un MenuItem oggetto da usare in un'altra posizione.

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

Vedi anche

• MainMenu
• Menu
• MenuMerge
• ContextMenu