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)

参数

注解

适用于

其他资源