MenuItem Costruttori

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Inizializza una nuova istanza della classe MenuItem.

Overload

MenuItem()	Inizializza un oggetto MenuItem con una didascalia vuota.
MenuItem(String)	Inizializza una nuova istanza della classe MenuItem con una didascalia specificata per la voce di menu.
MenuItem(String, EventHandler)	Inizializza una nuova istanza della classe con una didascalia specificata e un gestore eventi per l'evento Click della voce di menu.
MenuItem(String, MenuItem[])	Inizializza una nuova istanza della classe con una didascalia specificata e una matrice di voci di sottomenu definita per la voce di menu.
MenuItem(String, EventHandler, Shortcut)	Inizializza una nuova istanza della classe con una didascalia specificata, un gestore eventi e il tasto di scelta rapida per la voce di menu.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Inizializza una nuova istanza della classe MenuItem con una didascalia specifica, gestori eventi definiti per gli eventi Click, Select e Popup, un tasto di scelta rapida, un tipo di unione e un ordine specificati per la voce di menu.

MenuItem()

Inizializza un oggetto MenuItem con una didascalia vuota.

public:
 MenuItem();

public MenuItem ();

Public Sub New ()

Esempio

Nell'esempio di codice seguente viene creato un MenuItem oggetto usando questa versione del costruttore.

public:
   void CreateMyMenu()
   {
      // Create an empty menu item object.
      MenuItem^ menuItem1 = gcnew MenuItem;
      // Intialize the menu item using the parameterless version of the constructor.
      // Set the caption of the menu item.
      menuItem1->Text = "&File";
   }

public void CreateMyMenu()
{
   // Create an empty menu item object.
   MenuItem menuItem1 = new MenuItem();
   // Intialize the menu item using the parameterless version of the constructor.
   // Set the caption of the menu item.
   menuItem1.Text = "&File";
}

Public Sub CreateMyMenu()
    ' Create an empty menu item object.
    Dim menuItem1 As New MenuItem()
    ' Intialize the menu item using the parameterless version of the constructor.
    ' Set the caption of the menu item.
    menuItem1.Text = "&File"
End Sub

Commenti

Dopo aver creato un oggetto vuoto MenuItem usando questo costruttore, è possibile usare le proprietà e i metodi della classe per specificare l'aspetto e il comportamento dell'oggetto MenuItemMenuItem.

MenuItem(String)

Inizializza una nuova istanza della classe MenuItem con una didascalia specificata per la voce di menu.

public:
 MenuItem(System::String ^ text);

public MenuItem (string text);

new System.Windows.Forms.MenuItem : string -> System.Windows.Forms.MenuItem

Public Sub New (text As String)

Parametri

text

String

Didascalia della voce di menu.

Esempio

Nell'esempio di codice seguente viene creato un oggetto MenuItem che specifica la didascalia della voce di menu al momento della costruzione.

public:
   void CreateMyMenus()
   {
      // Create an instance of a MenuItem with a specified caption.
      menuItem1 = gcnew MenuItem( "&File" );
   }

public void CreateMyMenus()
{
   // Create an instance of a MenuItem with a specified caption.
   menuItem1 = new MenuItem("&File");
}

Public Sub CreateMyMenus()
    ' Create an instance of a MenuItem with a specified caption.
    menuItem1 = New MenuItem("&File")
End Sub

Commenti

Quando si specifica un didascalia per la voce di menu con il text parametro, è anche possibile specificare una chiave di accesso inserendo un carattere "&" prima che il carattere venga usato come chiave di accesso. Ad esempio, per specificare "F" in "File" come chiave di accesso, si specifica il didascalia per la voce di menu come "&File". È possibile usare questa funzionalità per fornire lo spostamento da tastiera per i menu.

L'impostazione del text parametro su "-" causa la visualizzazione della voce di menu come separatore (riga orizzontale) anziché una voce di menu standard.

MenuItem(String, EventHandler)

Inizializza una nuova istanza della classe con una didascalia specificata e un gestore eventi per l'evento Click della voce di menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick);

public MenuItem (string text, EventHandler onClick);

new System.Windows.Forms.MenuItem : string * EventHandler -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler)

Parametri

text

String

Didascalia della voce di menu.

onClick

EventHandler

Oggetto EventHandler che gestisce l'evento Click per la voce di menu.

Esempio

Nell'esempio di codice seguente viene creato un MenuItem oggetto con un didascalia specificato e un EventHandler delegato connesso a un gestore eventi che gestirà l'evento Click per la voce di menu.

public:
   void CreateMyMenuItem()
   {
      // Create an instance of MenuItem with caption and an event handler
      MenuItem^ menuItem1 = gcnew MenuItem( "&New",gcnew System::EventHandler(
         this, &Form1::MenuItem1_Click ) );
   }

private:
   // This method is an event handler for menuItem1 to use when connecting its event handler.
   void MenuItem1_Click( Object^ sender, System::EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create an instance of MenuItem with caption and an event handler
   MenuItem menuItem1 = new MenuItem("&New", new System.EventHandler(this.MenuItem1_Click));
}

// This method is an event handler for menuItem1 to use when connecting its event handler.
private void MenuItem1_Click(Object sender, System.EventArgs e) 
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create an instance of MenuItem with caption and an event 
    ' handler
    Dim MenuItem1 As New MenuItem("&New", New _
        System.EventHandler(AddressOf Me.MenuItem1_Click))
End Sub
' This method is an event handler for MenuItem1 to use when 
' connecting its event handler.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal _
    e as System.EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Commenti

Quando si specifica un didascalia per la voce di menu con il text parametro, è anche possibile specificare una chiave di accesso inserendo un '&' prima che il carattere venga usato come chiave di accesso. Ad esempio, per specificare "F" in "File" come chiave di accesso, si specifica il didascalia per la voce di menu come "&File". È possibile usare questa funzionalità per fornire lo spostamento da tastiera per i menu.

L'impostazione del text parametro su "-" causa la visualizzazione della voce di menu come separatore (riga orizzontale) anziché una voce di menu standard.

È inoltre possibile usare questo costruttore per specificare un delegato che gestirà l'evento Click per la voce di menu da creare. L'oggetto EventHandler passato a questo costruttore deve essere configurato per chiamare un gestore eventi che può gestire l'evento Click . Per altre informazioni sulla gestione degli eventi, vedere Gestione e generazione di eventi.

MenuItem(String, MenuItem[])

Inizializza una nuova istanza della classe con una didascalia specificata e una matrice di voci di sottomenu definita per la voce di menu.

public:
 MenuItem(System::String ^ text, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (string text, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (text As String, items As MenuItem())

Parametri

text

String

Didascalia della voce di menu.

items

MenuItem[]

Matrice di oggetti MenuItem che contiene le voci di sottomenu per questa voce di menu.

Esempio

Nell'esempio di codice seguente viene creato un oggetto con un didascalia specificato, un gestore eventi connesso a un metodo che gestirà l'evento ogni voce di menu in una matrice di elementi di sottomenu.

public:
   void CreateMyMenuItem()
   {
      // submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      // Create an instance of a MenuItem with caption and an array of submenu
      // items specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&Colors",subMenus );
   }

public void CreateMyMenuItem()
{
   // submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");
   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   // Create an instance of a MenuItem with caption and an array of submenu
   // items specified.
   MenuItem MenuItem1 = new MenuItem("&Colors", subMenus);
}

Public Sub CreateMyMenuItem()
    ' submenu item array.
    Dim subMenus(3) As MenuItem
    ' Create three menu items to add to the submenu item array.
    Dim subMenuItem1 As New MenuItem("Red")
    Dim subMenuItem2 As New MenuItem("Blue")
    Dim subMenuItem3 As New MenuItem("Green")
    ' Add the submenu items to the array.
    subMenus(0) = subMenuItem1
    subMenus(1) = subMenuItem2
    subMenus(2) = subMenuItem3
    ' Create an instance of a MenuItem with caption and an array of submenu
    ' items specified.
    Dim MenuItem1 As New MenuItem("&Colors", subMenus)
End Sub

Commenti

Quando si specifica un didascalia per la voce di menu con il text parametro, è anche possibile specificare una chiave di accesso inserendo un '&' prima che il carattere venga usato come chiave di accesso. Ad esempio, per specificare "F" in "File" come chiave di accesso, si specifica il didascalia per la voce di menu come "&File". È possibile usare questa funzionalità per fornire lo spostamento da tastiera per i menu.

L'impostazione del text parametro su "-" causa la visualizzazione della voce di menu come separatore (riga orizzontale) anziché una voce di menu standard.

Il items parametro consente di assegnare una matrice di voci di menu per definire un sottomenu della voce di menu. Ogni elemento della matrice può avere anche una matrice di voci di menu assegnate. Ciò consente di creare strutture di menu complete e assegnarle al costruttore per la voce di menu.

Per altre informazioni sulla gestione degli eventi, vedere Gestione e generazione di eventi.

MenuItem(String, EventHandler, Shortcut)

Inizializza una nuova istanza della classe con una didascalia specificata, un gestore eventi e il tasto di scelta rapida per la voce di menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick, System::Windows::Forms::Shortcut shortcut);

public MenuItem (string text, EventHandler onClick, System.Windows.Forms.Shortcut shortcut);

new System.Windows.Forms.MenuItem : string * EventHandler * System.Windows.Forms.Shortcut -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler, shortcut As Shortcut)

Parametri

text

String

Didascalia della voce di menu.

onClick

EventHandler

Oggetto EventHandler che gestisce l'evento Click per la voce di menu.

shortcut

Shortcut

Uno dei valori di Shortcut.

Esempio

Nell'esempio di codice seguente viene creato un oggetto con un didascalia specificato, un tasto di scelta rapida e un gestore eventi connesso a un metodo che gestirà l'evento per la voce di menu.

public:
   void CreateMyMenuItem()
   {
      // Create a MenuItem with caption, shortcut key, and an event handler
      // specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&New",
         gcnew System::EventHandler( this, &Form1::MenuItem1_Click ), Shortcut::CtrlL );
   }

private:
   // The following method is an event handler for menuItem1 to use when
   // connecting the event handler.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create a MenuItem with caption, shortcut key, and an event handler
   // specified.
   MenuItem MenuItem1 = new MenuItem("&New",
       new System.EventHandler(this.MenuItem1_Click), Shortcut.CtrlL);
}

// The following method is an event handler for menuItem1 to use when
// connecting the event handler.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create a MenuItem with caption, shortcut key, and an event handler
    ' specified.
    Dim MenuItem1 As New MenuItem("&New", _
       New System.EventHandler(AddressOf Me.MenuItem1_Click), Shortcut.CtrlL)
End Sub    
   
' The following method is an event handler for menuItem1 to use when
' connecting the event handler.
Private Sub MenuItem1_Click(sender As Object, e As EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Commenti

Quando si specifica un didascalia per la voce di menu con il text parametro, è anche possibile specificare una chiave di accesso inserendo un '&' prima che il carattere venga usato come chiave di accesso. Ad esempio, per specificare "F" in "File" come chiave di accesso, si specifica il didascalia per la voce di menu come "&File". È possibile usare questa funzionalità per fornire lo spostamento da tastiera per i menu. Questo costruttore consente anche di specificare un tasto di scelta rapida oltre a un tasto di accesso per fornire lo spostamento da tastiera. I tasti di scelta rapida consentono di specificare una combinazione di tasti che possono essere usati per attivare la voce di menu.

L'impostazione del text parametro su "-" causa la visualizzazione della voce di menu come separatore (riga orizzontale) anziché una voce di menu standard.

È inoltre possibile usare questo costruttore per specificare un delegato che gestirà l'evento Click per la voce di menu da creare. L'oggetto EventHandler passato a questo costruttore deve essere configurato per chiamare un gestore eventi che può gestire l'evento Click . Per altre informazioni sulla gestione degli eventi, vedere Gestione e generazione di eventi.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inizializza una nuova istanza della classe MenuItem con una didascalia specifica, gestori eventi definiti per gli eventi Click, Select e Popup, un tasto di scelta rapida, un tipo di unione e un ordine specificati per la voce di menu.

public:
 MenuItem(System::Windows::Forms::MenuMerge mergeType, int mergeOrder, System::Windows::Forms::Shortcut shortcut, System::String ^ text, EventHandler ^ onClick, EventHandler ^ onPopup, EventHandler ^ onSelect, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (System.Windows.Forms.MenuMerge mergeType, int mergeOrder, System.Windows.Forms.Shortcut shortcut, string text, EventHandler onClick, EventHandler onPopup, EventHandler onSelect, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : System.Windows.Forms.MenuMerge * int * System.Windows.Forms.Shortcut * string * EventHandler * EventHandler * EventHandler * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (mergeType As MenuMerge, mergeOrder As Integer, shortcut As Shortcut, text As String, onClick As EventHandler, onPopup As EventHandler, onSelect As EventHandler, items As MenuItem())

Parametri

mergeType

MenuMerge

Uno dei valori di MenuMerge.

mergeOrder

Int32

Posizione relativa che verrà assunta da questa voce di menu in un menu unito.

shortcut

Shortcut

Uno dei valori di Shortcut.

text

String

Didascalia della voce di menu.

onClick

EventHandler

Oggetto EventHandler che gestisce l'evento Click per la voce di menu.

onPopup

EventHandler

Oggetto EventHandler che gestisce l'evento Popup per la voce di menu.

onSelect

EventHandler

Oggetto EventHandler che gestisce l'evento Select per la voce di menu.

items

MenuItem[]

Matrice di oggetti MenuItem che contiene le voci di sottomenu per questa voce di menu.

Esempio

Nell'esempio di codice seguente viene creata una voce di menu con un didascalia e un tasto di scelta rapida. La voce di menu include anche gestori eventi definiti per gli Popupeventi , Clicke Select . Se questa voce di menu viene unita, aggiungerà la voce di menu al menu con l'ordine di unione di zero.

public:
   void CreateMyMenuItem()
   {
      // Submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      /* Create a MenuItem with caption, shortcut key, 
         a Click, Popup, and Select event handler, merge type and order, and an 
         array of submenu items specified.
      */
      MenuItem^ menuItem1 = gcnew MenuItem( MenuMerge::Add, 0,
         Shortcut::CtrlShiftC, "&Colors",
         gcnew EventHandler( this, &Form1::MenuItem1_Click ),
         gcnew EventHandler( this, &Form1::MenuItem1_Popup ),
         gcnew EventHandler( this, &Form1::MenuItem1_Select ), subMenus );
   }

private:
   // The following method is an event handler for menuItem1 to use when connecting the Click event.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Popup event.
   void MenuItem1_Popup( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Select event
   void MenuItem1_Select( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");

   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   /* Create a MenuItem with caption, shortcut key, 
      a Click, Popup, and Select event handler, merge type and order, and an 
      array of submenu items specified.
   */
   MenuItem menuItem1 = new MenuItem(MenuMerge.Add, 0,
      Shortcut.CtrlShiftC, "&Colors", 
      new EventHandler(this.MenuItem1_Click),
      new EventHandler(this.MenuItem1_Popup),
      new EventHandler(this.MenuItem1_Select), subMenus);
}

// The following method is an event handler for menuItem1 to use when connecting the Click event.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Popup event.
private void MenuItem1_Popup(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Select event
private void MenuItem1_Select(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
   ' Submenu item array.
   Dim SubMenus(3) as MenuItem
   ' Create three menu items to add to the submenu item array.
   Dim SubMenuItem1, SubMenuItem2, SubMenuItem3 as MenuItem
   SubMenuItem1 = New MenuItem ("Red")
   SubMenuItem2 = New MenuItem ("Blue")
   SubMenuItem3 = New MenuItem ("Green")
   ' Add the submenu items to the array.
   SubMenus(0) = SubMenuItem1
   SubMenus(1) = SubMenuItem2
   SubMenus(2) = SubMenuItem3
   ' Create a MenuItem with caption, shortcut key, 
   ' a Click, Popup, and Select event handler, menu merge type and order, and an 
   ' array of submenu items specified.
   Dim MenuItem1 As MenuItem
   MenuItem1 = New MenuItem(MenuMerge.Add, 0, Shortcut.CtrlShiftC, "&Colors", _
      AddressOf Me.MenuItem1_Click, _
      AddressOf Me.MenuItem1_Popup, _
      AddressOf Me.MenuItem1_Select, SubMenus)
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Click event.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Popup event.
Private Sub MenuItem1_Popup(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Select event
Private Sub MenuItem1_Select(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

Commenti

Quando si specifica un didascalia per la voce di menu con il text parametro, è anche possibile specificare una chiave di accesso inserendo un '&' prima che il carattere venga usato come chiave di accesso. Ad esempio, per specificare "F" in "File" come chiave di accesso, si specifica il didascalia per la voce di menu come "&File". È possibile usare questa funzionalità per fornire lo spostamento da tastiera per i menu.

L'impostazione del text parametro su "-" causa la visualizzazione della voce di menu come separatore (riga orizzontale) anziché una voce di menu standard.

Il items parametro consente di assegnare una matrice di voci di menu per definire un sottomenu della voce di menu. Ogni elemento della matrice può avere anche una matrice di voci di menu assegnate. Ciò consente di creare strutture di menu complete e assegnarle al costruttore per la voce di menu.

I mergeType parametri e mergeOrder consentono di determinare il comportamento di questa voce di menu quando la voce di menu viene unita a un altro menu. A seconda del valore specificato per il mergeType parametro, è possibile aggiungere, rimuovere, sostituire o unire la voce di menu e le relative voci di sottomenu con il menu a cui viene unito. Il mergeOrder parametro determina dove verrà posizionata la voce di menu creata al momento dell'unione del menu.

È inoltre possibile usare questo costruttore per creare un MenuItem oggetto e connettersi a un gestore eventi nel codice che elabora il clic della voce di menu. L'oggetto EventHandler passato a questo costruttore deve essere configurato per chiamare un gestore eventi che può gestire l'evento Click . Usando questa versione del costruttore, è anche possibile connettere gli Popup eventi e Select per determinare quando questa voce di menu è selezionata. È possibile usare questi eventi per le attività, ad esempio determinare se visualizzare un segno di spunta accanto a elementi di sottomenu o per abilitare o disabilitare le voci di menu in base allo stato dell'applicazione. Gli Select eventi e Click vengono generati solo per MenuItem gli oggetti che non sono voci di menu padre. Per altre informazioni sulla gestione degli eventi, vedere Gestione e generazione di eventi.

Vedi anche

• Popup
• Select
• Click
• MergeType
• MergeOrder