Condividi tramite


ToolStripMenuItem Costruttori

Definizione

Inizializza una nuova istanza della classe ToolStripMenuItem.

Overload

ToolStripMenuItem()

Inizializza una nuova istanza della classe ToolStripMenuItem.

ToolStripMenuItem(Image)

Inizializza una nuova istanza della classe ToolStripMenuItem che consente di visualizzare l'oggetto Image specificato.

ToolStripMenuItem(String)

Inizializza una nuova istanza della classe ToolStripMenuItem che visualizza il testo specificato.

ToolStripMenuItem(String, Image)

Inizializza una nuova istanza della classe ToolStripMenuItem che visualizza il testo e l'immagine specificati.

ToolStripMenuItem(String, Image, EventHandler)

Inizializza una nuova istanza della classe ToolStripMenuItem con il testo e l'immagine specificati ed esegue l'azione specificata quando viene fatto clic su ToolStripMenuItem.

ToolStripMenuItem(String, Image, ToolStripItem[])

Inizializza una nuova istanza della classe ToolStripMenuItem che visualizza il testo e l'immagine specificati e contiene l'insieme ToolStripItem specificato.

ToolStripMenuItem(String, Image, EventHandler, String)

Inizializza una nuova istanza della classe ToolStripMenuItem con il nome specificato che consente di visualizzare il testo e l'immagine specificati ed esegue l'azione specificata quando viene fatto clic su ToolStripMenuItem.

ToolStripMenuItem(String, Image, EventHandler, Keys)

Inizializza una nuova istanza della classe ToolStripMenuItem con il testo e l'immagine specificati, che esegue l'azione specificata quando viene fatto clic su ToolStripMenuItem e che consente di visualizzare i tasti di scelta rapida specificati.

ToolStripMenuItem()

Inizializza una nuova istanza della classe ToolStripMenuItem.

public:
 ToolStripMenuItem();
public ToolStripMenuItem ();
Public Sub New ()

Si applica a

ToolStripMenuItem(Image)

Inizializza una nuova istanza della classe ToolStripMenuItem che consente di visualizzare l'oggetto Image specificato.

public:
 ToolStripMenuItem(System::Drawing::Image ^ image);
public ToolStripMenuItem (System.Drawing.Image image);
public ToolStripMenuItem (System.Drawing.Image? image);
new System.Windows.Forms.ToolStripMenuItem : System.Drawing.Image -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (image As Image)

Parametri

image
Image

Oggetto Image da visualizzare nel controllo.

Commenti

Usare il ToolStripMenuItem costruttore per creare un ToolStripMenuItem oggetto che visualizza un'immagine nel margine insieme al testo.

Si applica a

ToolStripMenuItem(String)

Inizializza una nuova istanza della classe ToolStripMenuItem che visualizza il testo specificato.

public:
 ToolStripMenuItem(System::String ^ text);
public ToolStripMenuItem (string text);
public ToolStripMenuItem (string? text);
new System.Windows.Forms.ToolStripMenuItem : string -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (text As String)

Parametri

text
String

Testo da visualizzare nella voce di menu.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del ToolStripMenuItem costruttore .

// Create a MenuStrip control with a new window.
MenuStrip ms = new MenuStrip();
ToolStripMenuItem windowMenu = new ToolStripMenuItem("Window");
ToolStripMenuItem windowNewMenu = new ToolStripMenuItem("New", null, new EventHandler(windowNewMenu_Click));
windowMenu.DropDownItems.Add(windowNewMenu);
((ToolStripDropDownMenu)(windowMenu.DropDown)).ShowImageMargin = false;
((ToolStripDropDownMenu)(windowMenu.DropDown)).ShowCheckMargin = true;

// Assign the ToolStripMenuItem that displays 
// the list of child forms.
ms.MdiWindowListItem = windowMenu;

// Add the window ToolStripMenuItem to the MenuStrip.
ms.Items.Add(windowMenu);

// Dock the MenuStrip to the top of the form.
ms.Dock = DockStyle.Top;

// The Form.MainMenuStrip property determines the merge target.
this.MainMenuStrip = ms;
' Create a MenuStrip control with a new window.
Dim ms As New MenuStrip()
Dim windowMenu As New ToolStripMenuItem("Window")
Dim windowNewMenu As New ToolStripMenuItem("New", Nothing, New EventHandler(AddressOf windowNewMenu_Click))
windowMenu.DropDownItems.Add(windowNewMenu)
CType(windowMenu.DropDown, ToolStripDropDownMenu).ShowImageMargin = False
CType(windowMenu.DropDown, ToolStripDropDownMenu).ShowCheckMargin = True

' Assign the ToolStripMenuItem that displays 
' the list of child forms.
ms.MdiWindowListItem = windowMenu

' Add the window ToolStripMenuItem to the MenuStrip.
ms.Items.Add(windowMenu)

' Dock the MenuStrip to the top of the form.
ms.Dock = DockStyle.Top

' The Form.MainMenuStrip property determines the merge target.
Me.MainMenuStrip = ms

Commenti

Usare il ToolStripMenuItem costruttore per creare un ToolStripMenuItem oggetto con il nome specificato.

Si applica a

ToolStripMenuItem(String, Image)

Inizializza una nuova istanza della classe ToolStripMenuItem che visualizza il testo e l'immagine specificati.

public:
 ToolStripMenuItem(System::String ^ text, System::Drawing::Image ^ image);
public ToolStripMenuItem (string text, System.Drawing.Image image);
public ToolStripMenuItem (string? text, System.Drawing.Image? image);
new System.Windows.Forms.ToolStripMenuItem : string * System.Drawing.Image -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (text As String, image As Image)

Parametri

text
String

Testo da visualizzare nella voce di menu.

image
Image

Oggetto Image da visualizzare nel controllo.

Commenti

Usare il ToolStripMenuItem costruttore per creare un ToolStripMenuItem oggetto con il nome e l'immagine specificati.

Si applica a

ToolStripMenuItem(String, Image, EventHandler)

Inizializza una nuova istanza della classe ToolStripMenuItem con il testo e l'immagine specificati ed esegue l'azione specificata quando viene fatto clic su ToolStripMenuItem.

public:
 ToolStripMenuItem(System::String ^ text, System::Drawing::Image ^ image, EventHandler ^ onClick);
public ToolStripMenuItem (string text, System.Drawing.Image image, EventHandler onClick);
public ToolStripMenuItem (string? text, System.Drawing.Image? image, EventHandler? onClick);
new System.Windows.Forms.ToolStripMenuItem : string * System.Drawing.Image * EventHandler -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (text As String, image As Image, onClick As EventHandler)

Parametri

text
String

Testo da visualizzare nella voce di menu.

image
Image

Oggetto Image da visualizzare nel controllo.

onClick
EventHandler

Gestore eventi che genera l'evento Click quando viene fatto clic sul controllo.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del ToolStripMenuItem costruttore .

// Create a MenuStrip control with a new window.
MenuStrip ms = new MenuStrip();
ToolStripMenuItem windowMenu = new ToolStripMenuItem("Window");
ToolStripMenuItem windowNewMenu = new ToolStripMenuItem("New", null, new EventHandler(windowNewMenu_Click));
windowMenu.DropDownItems.Add(windowNewMenu);
((ToolStripDropDownMenu)(windowMenu.DropDown)).ShowImageMargin = false;
((ToolStripDropDownMenu)(windowMenu.DropDown)).ShowCheckMargin = true;

// Assign the ToolStripMenuItem that displays 
// the list of child forms.
ms.MdiWindowListItem = windowMenu;

// Add the window ToolStripMenuItem to the MenuStrip.
ms.Items.Add(windowMenu);

// Dock the MenuStrip to the top of the form.
ms.Dock = DockStyle.Top;

// The Form.MainMenuStrip property determines the merge target.
this.MainMenuStrip = ms;
' Create a MenuStrip control with a new window.
Dim ms As New MenuStrip()
Dim windowMenu As New ToolStripMenuItem("Window")
Dim windowNewMenu As New ToolStripMenuItem("New", Nothing, New EventHandler(AddressOf windowNewMenu_Click))
windowMenu.DropDownItems.Add(windowNewMenu)
CType(windowMenu.DropDown, ToolStripDropDownMenu).ShowImageMargin = False
CType(windowMenu.DropDown, ToolStripDropDownMenu).ShowCheckMargin = True

' Assign the ToolStripMenuItem that displays 
' the list of child forms.
ms.MdiWindowListItem = windowMenu

' Add the window ToolStripMenuItem to the MenuStrip.
ms.Items.Add(windowMenu)

' Dock the MenuStrip to the top of the form.
ms.Dock = DockStyle.Top

' The Form.MainMenuStrip property determines the merge target.
Me.MainMenuStrip = ms

Commenti

Utilizzare per ToolStripMenuItem creare un ToolStripMenuItem oggetto che visualizza sia il testo che un'immagine e che esegue l'azione specificata quando ToolStripMenuItem si fa clic su .

Si applica a

ToolStripMenuItem(String, Image, ToolStripItem[])

Inizializza una nuova istanza della classe ToolStripMenuItem che visualizza il testo e l'immagine specificati e contiene l'insieme ToolStripItem specificato.

public:
 ToolStripMenuItem(System::String ^ text, System::Drawing::Image ^ image, ... cli::array <System::Windows::Forms::ToolStripItem ^> ^ dropDownItems);
public ToolStripMenuItem (string text, System.Drawing.Image image, params System.Windows.Forms.ToolStripItem[] dropDownItems);
public ToolStripMenuItem (string? text, System.Drawing.Image? image, params System.Windows.Forms.ToolStripItem[]? dropDownItems);
new System.Windows.Forms.ToolStripMenuItem : string * System.Drawing.Image * System.Windows.Forms.ToolStripItem[] -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (text As String, image As Image, ParamArray dropDownItems As ToolStripItem())

Parametri

text
String

Testo da visualizzare nella voce di menu.

image
Image

Oggetto Image da visualizzare nel controllo.

dropDownItems
ToolStripItem[]

Voce di menu da visualizzare quando si fa clic sul controllo.

Commenti

Usare il ToolStripMenuItem costruttore per creare un ToolStripMenuItem oggetto che visualizza testo e un'immagine e che contiene la raccolta specificata ToolStripItem .

Si applica a

ToolStripMenuItem(String, Image, EventHandler, String)

Inizializza una nuova istanza della classe ToolStripMenuItem con il nome specificato che consente di visualizzare il testo e l'immagine specificati ed esegue l'azione specificata quando viene fatto clic su ToolStripMenuItem.

public:
 ToolStripMenuItem(System::String ^ text, System::Drawing::Image ^ image, EventHandler ^ onClick, System::String ^ name);
public ToolStripMenuItem (string text, System.Drawing.Image image, EventHandler onClick, string name);
public ToolStripMenuItem (string? text, System.Drawing.Image? image, EventHandler? onClick, string? name);
new System.Windows.Forms.ToolStripMenuItem : string * System.Drawing.Image * EventHandler * string -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (text As String, image As Image, onClick As EventHandler, name As String)

Parametri

text
String

Testo da visualizzare nella voce di menu.

image
Image

Oggetto Image da visualizzare nel controllo.

onClick
EventHandler

Gestore eventi che genera l'evento Click quando viene fatto clic sul controllo.

name
String

Nome della voce di menu.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del ToolStripMenuItem costruttore .

// This code example demonstrates how to handle the Opening event.
// It also demonstrates dynamic item addition and dynamic 
// SourceControl determination with reuse.
class Form3 : Form
{
    // Declare the ContextMenuStrip control.
    private ContextMenuStrip fruitContextMenuStrip;

    public Form3()
    {
        // Create a new ContextMenuStrip control.
        fruitContextMenuStrip = new ContextMenuStrip();

        // Attach an event handler for the 
        // ContextMenuStrip control's Opening event.
        fruitContextMenuStrip.Opening += new System.ComponentModel.CancelEventHandler(cms_Opening);

        // Create a new ToolStrip control.
        ToolStrip ts = new ToolStrip();

        // Create a ToolStripDropDownButton control and add it
        // to the ToolStrip control's Items collections.
        ToolStripDropDownButton fruitToolStripDropDownButton = new ToolStripDropDownButton("Fruit", null, null, "Fruit");
        ts.Items.Add(fruitToolStripDropDownButton);

        // Dock the ToolStrip control to the top of the form.
        ts.Dock = DockStyle.Top;

        // Assign the ContextMenuStrip control as the 
        // ToolStripDropDownButton control's DropDown menu.
        fruitToolStripDropDownButton.DropDown = fruitContextMenuStrip;

        // Create a new MenuStrip control and add a ToolStripMenuItem.
        MenuStrip ms = new MenuStrip();
        ToolStripMenuItem fruitToolStripMenuItem = new ToolStripMenuItem("Fruit", null, null, "Fruit");
        ms.Items.Add(fruitToolStripMenuItem);

        // Dock the MenuStrip control to the top of the form.
        ms.Dock = DockStyle.Top;

        // Assign the MenuStrip control as the 
        // ToolStripMenuItem's DropDown menu.
        fruitToolStripMenuItem.DropDown = fruitContextMenuStrip;

        // Assign the ContextMenuStrip to the form's 
        // ContextMenuStrip property.
        this.ContextMenuStrip = fruitContextMenuStrip;

        // Add the ToolStrip control to the Controls collection.
        this.Controls.Add(ts);

        //Add a button to the form and assign its ContextMenuStrip.
        Button b = new Button();
        b.Location = new System.Drawing.Point(60, 60);
        this.Controls.Add(b);
        b.ContextMenuStrip = fruitContextMenuStrip;

        // Add the MenuStrip control last.
        // This is important for correct placement in the z-order.
        this.Controls.Add(ms);
    }

    // This event handler is invoked when the ContextMenuStrip
    // control's Opening event is raised. It demonstrates
    // dynamic item addition and dynamic SourceControl 
    // determination with reuse.
    void cms_Opening(object sender, System.ComponentModel.CancelEventArgs e)
    {
        // Acquire references to the owning control and item.
        Control c = fruitContextMenuStrip.SourceControl as Control;
        ToolStripDropDownItem tsi = fruitContextMenuStrip.OwnerItem as ToolStripDropDownItem;

        // Clear the ContextMenuStrip control's Items collection.
        fruitContextMenuStrip.Items.Clear();

        // Check the source control first.
        if (c != null)
        {
            // Add custom item (Form)
            fruitContextMenuStrip.Items.Add("Source: " + c.GetType().ToString());
        }
        else if (tsi != null)
        {
            // Add custom item (ToolStripDropDownButton or ToolStripMenuItem)
            fruitContextMenuStrip.Items.Add("Source: " + tsi.GetType().ToString());
        }

        // Populate the ContextMenuStrip control with its default items.
        fruitContextMenuStrip.Items.Add("-");
        fruitContextMenuStrip.Items.Add("Apples");
        fruitContextMenuStrip.Items.Add("Oranges");
        fruitContextMenuStrip.Items.Add("Pears");

        // Set Cancel to false. 
        // It is optimized to true based on empty entry.
        e.Cancel = false;
    }
}
' This code example demonstrates how to handle the Opening event.
' It also demonstrates dynamic item addition and dynamic 
' SourceControl determination with reuse.
Class Form3
    Inherits Form

   ' Declare the ContextMenuStrip control.
   Private fruitContextMenuStrip As ContextMenuStrip
   
   
   Public Sub New()
      ' Create a new ContextMenuStrip control.
      fruitContextMenuStrip = New ContextMenuStrip()
      
      ' Attach an event handler for the 
      ' ContextMenuStrip control's Opening event.
      AddHandler fruitContextMenuStrip.Opening, AddressOf cms_Opening
      
      ' Create a new ToolStrip control.
      Dim ts As New ToolStrip()
      
      ' Create a ToolStripDropDownButton control and add it
      ' to the ToolStrip control's Items collections.
      Dim fruitToolStripDropDownButton As New ToolStripDropDownButton("Fruit", Nothing, Nothing, "Fruit")
      ts.Items.Add(fruitToolStripDropDownButton)
      
      ' Dock the ToolStrip control to the top of the form.
      ts.Dock = DockStyle.Top
      
      ' Assign the ContextMenuStrip control as the 
      ' ToolStripDropDownButton control's DropDown menu.
      fruitToolStripDropDownButton.DropDown = fruitContextMenuStrip
      
      ' Create a new MenuStrip control and add a ToolStripMenuItem.
      Dim ms As New MenuStrip()
      Dim fruitToolStripMenuItem As New ToolStripMenuItem("Fruit", Nothing, Nothing, "Fruit")
      ms.Items.Add(fruitToolStripMenuItem)
      
      ' Dock the MenuStrip control to the top of the form.
      ms.Dock = DockStyle.Top
      
      ' Assign the MenuStrip control as the 
      ' ToolStripMenuItem's DropDown menu.
      fruitToolStripMenuItem.DropDown = fruitContextMenuStrip
      
      ' Assign the ContextMenuStrip to the form's 
      ' ContextMenuStrip property.
      Me.ContextMenuStrip = fruitContextMenuStrip
      
      ' Add the ToolStrip control to the Controls collection.
        Me.Controls.Add(ts)

        'Add a button to the form and assign its ContextMenuStrip.
        Dim b As New Button()
        b.Location = New System.Drawing.Point(60, 60)
        Me.Controls.Add(b)
        b.ContextMenuStrip = fruitContextMenuStrip
      
      ' Add the MenuStrip control last.
      ' This is important for correct placement in the z-order.
      Me.Controls.Add(ms)
    End Sub
   
   ' This event handler is invoked when the ContextMenuStrip
   ' control's Opening event is raised. It demonstrates
   ' dynamic item addition and dynamic SourceControl 
   ' determination with reuse.
    Sub cms_Opening(ByVal sender As Object, ByVal e As System.ComponentModel.CancelEventArgs)

        ' Acquire references to the owning control and item.
        Dim c As Control = fruitContextMenuStrip.SourceControl
        Dim tsi As ToolStripDropDownItem = fruitContextMenuStrip.OwnerItem 

        ' Clear the ContextMenuStrip control's 
        ' Items collection.
        fruitContextMenuStrip.Items.Clear()

        ' Check the source control first.
        If (c IsNot Nothing) Then
            ' Add custom item (Form)
            fruitContextMenuStrip.Items.Add(("Source: " + c.GetType().ToString()))
        ElseIf (tsi IsNot Nothing) Then
            ' Add custom item (ToolStripDropDownButton or ToolStripMenuItem)
            fruitContextMenuStrip.Items.Add(("Source: " + tsi.GetType().ToString()))
        End If

        ' Populate the ContextMenuStrip control with its default items.
        fruitContextMenuStrip.Items.Add("-")
        fruitContextMenuStrip.Items.Add("Apples")
        fruitContextMenuStrip.Items.Add("Oranges")
        fruitContextMenuStrip.Items.Add("Pears")

        ' Set Cancel to false. 
        ' It is optimized to true based on empty entry.
        e.Cancel = False
    End Sub
End Class

Si applica a

ToolStripMenuItem(String, Image, EventHandler, Keys)

Inizializza una nuova istanza della classe ToolStripMenuItem con il testo e l'immagine specificati, che esegue l'azione specificata quando viene fatto clic su ToolStripMenuItem e che consente di visualizzare i tasti di scelta rapida specificati.

public:
 ToolStripMenuItem(System::String ^ text, System::Drawing::Image ^ image, EventHandler ^ onClick, System::Windows::Forms::Keys shortcutKeys);
public ToolStripMenuItem (string text, System.Drawing.Image image, EventHandler onClick, System.Windows.Forms.Keys shortcutKeys);
public ToolStripMenuItem (string? text, System.Drawing.Image? image, EventHandler? onClick, System.Windows.Forms.Keys shortcutKeys);
new System.Windows.Forms.ToolStripMenuItem : string * System.Drawing.Image * EventHandler * System.Windows.Forms.Keys -> System.Windows.Forms.ToolStripMenuItem
Public Sub New (text As String, image As Image, onClick As EventHandler, shortcutKeys As Keys)

Parametri

text
String

Testo da visualizzare nella voce di menu.

image
Image

Oggetto Image da visualizzare nel controllo.

onClick
EventHandler

Gestore eventi che genera l'evento Click quando viene fatto clic sul controllo.

shortcutKeys
Keys

Uno dei valori di Keys che rappresenta il tasto di scelta rapida per ToolStripMenuItem.

Commenti

Usare il ToolStripMenuItem costruttore per creare un ToolStripMenuItem oggetto che visualizza testo e un'immagine, esegue l'azione specificata quando si fa clic e ha il tasto di scelta rapida specificato.

Si applica a