ToolStripMenuItem 建構函式

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 ToolStripMenuItem 類別的新執行個體。

多載

ToolStripMenuItem()	初始化 ToolStripMenuItem 類別的新執行個體。
ToolStripMenuItem(Image)	初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的 Image。
ToolStripMenuItem(String)	初始化 ToolStripMenuItem 類別的新執行個體，以便顯示指定的文字。
ToolStripMenuItem(String, Image)	初始化 ToolStripMenuItem 類別的新執行個體，以便顯示指定的文字和影像。
ToolStripMenuItem(String, Image, EventHandler)	初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的文字和影像，並當按一下 ToolStripMenuItem 後會執行指定的動作。
ToolStripMenuItem(String, Image, ToolStripItem[])	初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的文字和影像，並包含指定的 ToolStripItem 集合。
ToolStripMenuItem(String, Image, EventHandler, String)	使用指定的名稱初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示按一下 ToolStripMenuItem 後會執行指定之動作的指定文字和影像。
ToolStripMenuItem(String, Image, EventHandler, Keys)	初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的文字和影像，當按一下 ToolStripMenuItem 後會執行指定的動作，並顯示指定的快速鍵。

ToolStripMenuItem()

初始化 ToolStripMenuItem 類別的新執行個體。

public:
 ToolStripMenuItem();

public ToolStripMenuItem ();

Public Sub New ()

適用於

ToolStripMenuItem(Image)

初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的 Image。

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)

參數

image: Image

要顯示於控制項上的 Image。

備註

使用建 ToolStripMenuItem 構函式來建立， ToolStripMenuItem 以在邊界與文字旁邊顯示影像。

適用於

ToolStripMenuItem(String)

初始化 ToolStripMenuItem 類別的新執行個體，以便顯示指定的文字。

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)

參數

text: String

要顯示在功能表項目上的文字。

範例

下列程式碼範例示範如何使用建 ToolStripMenuItem 構函式。

// 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

備註

使用建 ToolStripMenuItem 構函式建立 ToolStripMenuItem 具有指定名稱的。

適用於

ToolStripMenuItem(String, Image)

初始化 ToolStripMenuItem 類別的新執行個體，以便顯示指定的文字和影像。

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)

參數

text: String

要顯示在功能表項目上的文字。

image: Image

要顯示於控制項上的 Image。

備註

使用建 ToolStripMenuItem 構函式來建立 ToolStripMenuItem 具有指定名稱和映射的。

適用於

ToolStripMenuItem(String, Image, EventHandler)

初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的文字和影像，並當按一下 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)

參數

text: String

要顯示在功能表項目上的文字。

image: Image

要顯示於控制項上的 Image。

onClick: EventHandler

當按下控制項時引發 Click 事件的事件處理常式。

範例

下列程式碼範例示範如何使用建 ToolStripMenuItem 構函式。

// 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

備註

ToolStripMenuItem使用建立， ToolStripMenuItem 以顯示文字和影像，並在按一下時 ToolStripMenuItem 執行指定的動作。

適用於

ToolStripMenuItem(String, Image, ToolStripItem[])

初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的文字和影像，並包含指定的 ToolStripItem 集合。

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())

參數

text: String

要顯示在功能表項目上的文字。

image: Image

要顯示於控制項上的 Image。

dropDownItems: ToolStripItem[]

按一下此控制項時，所要顯示的功能表項目。

備註

使用建 ToolStripMenuItem 構函式建立， ToolStripMenuItem 以顯示文字和影像，以及包含指定 ToolStripItem 集合的。

適用於

ToolStripMenuItem(String, Image, EventHandler, String)

使用指定的名稱初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示按一下 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)

參數

text: String

要顯示在功能表項目上的文字。

image: Image

要顯示於控制項上的 Image。

onClick: EventHandler

當按下控制項時引發 Click 事件的事件處理常式。

name: String

功能表項目的名稱。

範例

下列程式碼範例示範如何使用建 ToolStripMenuItem 構函式。

// 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

適用於

ToolStripMenuItem(String, Image, EventHandler, Keys)

初始化 ToolStripMenuItem 類別的新執行個體，該類別顯示指定的文字和影像，當按一下 ToolStripMenuItem 後會執行指定的動作，並顯示指定的快速鍵。

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)

參數

text: String

要顯示在功能表項目上的文字。

image: Image

要顯示於控制項上的 Image。

onClick: EventHandler

當按下控制項時引發 Click 事件的事件處理常式。

shortcutKeys: Keys

其中一個 Keys 值，表示 ToolStripMenuItem 的快速鍵。

備註

使用建 ToolStripMenuItem 構函式建立 ToolStripMenuItem ，以顯示文字和影像、按一下時執行指定的動作，以及具有指定的快速鍵。

適用於

共用方式為

ToolStripMenuItem 建構函式

定義

多載

ToolStripMenuItem()

適用於

ToolStripMenuItem(Image)

參數

備註

適用於

ToolStripMenuItem(String)

參數

範例

備註

適用於

ToolStripMenuItem(String, Image)

參數

備註

適用於

ToolStripMenuItem(String, Image, EventHandler)

參數

範例

備註

適用於

ToolStripMenuItem(String, Image, ToolStripItem[])

參數

備註

適用於

ToolStripMenuItem(String, Image, EventHandler, String)

參數

範例

適用於

ToolStripMenuItem(String, Image, EventHandler, Keys)

參數

備註

適用於

其他資源