ToolStripMenuItem Constructores
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase ToolStripMenuItem.
| ToolStripMenuItem() |
Inicializa una nueva instancia de la clase ToolStripMenuItem. |
| ToolStripMenuItem(Image) |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra el Image especificado. |
| ToolStripMenuItem(String) |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra el texto especificado. |
| ToolStripMenuItem(String, Image) |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra la imagen y el texto especificados. |
| ToolStripMenuItem(String, Image, EventHandler) |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra la imagen y el texto especificados, y realiza la acción especificada cuando se hace clic en ToolStripMenuItem. |
| ToolStripMenuItem(String, Image, ToolStripItem[]) |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra la imagen y el texto especificados, y que contiene la colección ToolStripItem especificada. |
| ToolStripMenuItem(String, Image, EventHandler, String) |
Inicializa una nueva instancia de la clase ToolStripMenuItem con el nombre especificado que muestra la imagen y el texto especificados, y realiza la acción especificada cuando se hace clic en ToolStripMenuItem. |
| ToolStripMenuItem(String, Image, EventHandler, Keys) |
Inicializa una nueva instancia de la clase ToolStripMenuItem con la imagen y el texto especificados, realiza la acción especificada cuando se hace clic en ToolStripMenuItem y muestra las teclas de método abreviado especificado. |
Inicializa una nueva instancia de la clase ToolStripMenuItem.
public:
ToolStripMenuItem();public ToolStripMenuItem ();Public Sub New ()Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra el Image especificado.
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.ToolStripMenuItemPublic Sub New (image As Image)Parámetros
Comentarios
Use el ToolStripMenuItem constructor para crear un ToolStripMenuItem objeto que muestre una imagen en el margen junto con el texto.
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra el texto especificado.
public:
ToolStripMenuItem(System::String ^ text);public ToolStripMenuItem (string text);public ToolStripMenuItem (string? text);new System.Windows.Forms.ToolStripMenuItem : string -> System.Windows.Forms.ToolStripMenuItemPublic Sub New (text As String)Parámetros
- text
- String
Texto que se va a mostrar en el elemento de menú.
Ejemplos
En el ejemplo de código siguiente se muestra un uso del ToolStripMenuItem constructor .
// 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
Comentarios
Use el ToolStripMenuItem constructor para crear un ToolStripMenuItem con el nombre especificado.
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra la imagen y el texto especificados.
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.ToolStripMenuItemPublic Sub New (text As String, image As Image)Parámetros
- text
- String
Texto que se va a mostrar en el elemento de menú.
Comentarios
Use el ToolStripMenuItem constructor para crear un ToolStripMenuItem con el nombre y la imagen especificados.
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra la imagen y el texto especificados, y realiza la acción especificada cuando se hace clic en 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.ToolStripMenuItemPublic Sub New (text As String, image As Image, onClick As EventHandler)Parámetros
- text
- String
Texto que se va a mostrar en el elemento de menú.
- onClick
- EventHandler
Un controlador de eventos que provoca el evento Click cuando se hace clic en el control.
Ejemplos
En el ejemplo de código siguiente se muestra un uso del ToolStripMenuItem constructor .
// 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
Comentarios
ToolStripMenuItem Use para crear un ToolStripMenuItem objeto que muestre texto y una imagen y que realice la acción especificada cuando se haga clic en .ToolStripMenuItem
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem que muestra la imagen y el texto especificados, y que contiene la colección ToolStripItem especificada.
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.ToolStripMenuItemPublic Sub New (text As String, image As Image, ParamArray dropDownItems As ToolStripItem())Parámetros
- text
- String
Texto que se va a mostrar en el elemento de menú.
- dropDownItems
- ToolStripItem[]
Elementos de menú que se mostrarán al hacer clic en el control.
Comentarios
Use el ToolStripMenuItem constructor para crear un ToolStripMenuItem objeto que muestre texto y una imagen y que contenga la colección especificada ToolStripItem .
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem con el nombre especificado que muestra la imagen y el texto especificados, y realiza la acción especificada cuando se hace clic en 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.ToolStripMenuItemPublic Sub New (text As String, image As Image, onClick As EventHandler, name As String)Parámetros
- text
- String
Texto que se va a mostrar en el elemento de menú.
- onClick
- EventHandler
Un controlador de eventos que provoca el evento Click cuando se hace clic en el control.
- name
- String
Nombre del elemento de menú.
Ejemplos
En el ejemplo de código siguiente se muestra un uso del ToolStripMenuItem constructor .
// 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
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Inicializa una nueva instancia de la clase ToolStripMenuItem con la imagen y el texto especificados, realiza la acción especificada cuando se hace clic en ToolStripMenuItem y muestra las teclas de método abreviado especificado.
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.ToolStripMenuItemPublic Sub New (text As String, image As Image, onClick As EventHandler, shortcutKeys As Keys)Parámetros
- text
- String
Texto que se va a mostrar en el elemento de menú.
- onClick
- EventHandler
Un controlador de eventos que provoca el evento Click cuando se hace clic en el control.
- shortcutKeys
- Keys
Uno de los valores de Keys que representa la tecla de método abreviado para ToolStripMenuItem.
Comentarios
Use el ToolStripMenuItem constructor para crear un ToolStripMenuItem objeto que muestre texto y una imagen, realice la acción especificada cuando se haga clic en y tenga la tecla de método abreviado especificada.
Se aplica a
.NET Framework 4.8.1 y otras versiones
| Producto | Versiones |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: