ToolStripMenuItem Constructeurs

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Initialise une nouvelle instance de la classe ToolStripMenuItem.

Surcharges

Nom	Description
ToolStripMenuItem()	Initialise une nouvelle instance de la classe ToolStripMenuItem.
ToolStripMenuItem(Image)	Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le fichier spécifié Image.
ToolStripMenuItem(String)	Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte spécifié.
ToolStripMenuItem(String, Image)	Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés.
ToolStripMenuItem(String, Image, EventHandler)	Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés et qui effectue l’action spécifiée lorsque l’utilisateur ToolStripMenuItem clique dessus.
ToolStripMenuItem(String, Image, ToolStripItem[])	Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés et qui contient la collection spécifiée ToolStripItem .
ToolStripMenuItem(String, Image, EventHandler, String)	Initialise une nouvelle instance de la ToolStripMenuItem classe avec le nom spécifié qui affiche le texte et l’image spécifiés qui effectuent l’action spécifiée lorsque l’utilisateur ToolStripMenuItem clique dessus.
ToolStripMenuItem(String, Image, EventHandler, Keys)	Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés, effectue l’action spécifiée lorsque le ToolStripMenuItem clic est fait et affiche les touches de raccourci spécifiées.

ToolStripMenuItem()

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la classe ToolStripMenuItem.

public:
 ToolStripMenuItem();

public ToolStripMenuItem();

Public Sub New ()

ToolStripMenuItem(Image)

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le fichier spécifié 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)

Paramètres

image

Image

À Image afficher sur le contrôle.

Remarques

Utilisez le ToolStripMenuItem constructeur pour créer une ToolStripMenuItem image qui affiche une image dans la marge en même temps que le texte.

ToolStripMenuItem(String)

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte spécifié.

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

public ToolStripMenuItem(string? text);

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

Public Sub New (text As String)

Paramètres

text

String

Texte à afficher sur l’élément de menu.

Exemples

L’exemple de code suivant illustre une utilisation du ToolStripMenuItem constructeur.

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

Remarques

Utilisez le ToolStripMenuItem constructeur pour créer un ToolStripMenuItem nom spécifié.

ToolStripMenuItem(String, Image)

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés.

public:
 ToolStripMenuItem(System::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)

Paramètres

text

String

Texte à afficher sur l’élément de menu.

image

Image

À Image afficher sur le contrôle.

Remarques

Utilisez le ToolStripMenuItem constructeur pour créer un ToolStripMenuItem nom et une image spécifiés.

ToolStripMenuItem(String, Image, EventHandler)

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés et qui effectue l’action spécifiée lorsque l’utilisateur ToolStripMenuItem clique dessus.

public:
 ToolStripMenuItem(System::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)

Paramètres

text

String

Texte à afficher sur l’élément de menu.

image

Image

À Image afficher sur le contrôle.

onClick

EventHandler

Gestionnaire d’événements qui déclenche l’événement Click lorsque le contrôle est cliqué.

Exemples

L’exemple de code suivant illustre une utilisation du ToolStripMenuItem constructeur.

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

Remarques

Utilisez la ToolStripMenuItem méthode pour créer un ToolStripMenuItem élément qui affiche à la fois du texte et une image et qui effectue l’action spécifiée lorsque le ToolStripMenuItem clic est fait.

ToolStripMenuItem(String, Image, ToolStripItem[])

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés et qui contient la collection spécifiée 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);

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

Paramètres

text

String

Texte à afficher sur l’élément de menu.

image

Image

À Image afficher sur le contrôle.

dropDownItems

ToolStripItem[]

Éléments de menu à afficher lorsque le contrôle est cliqué.

Remarques

Utilisez le ToolStripMenuItem constructeur pour créer un ToolStripMenuItem texte qui affiche du texte et une image et qui contient la collection spécifiée ToolStripItem .

ToolStripMenuItem(String, Image, EventHandler, String)

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe avec le nom spécifié qui affiche le texte et l’image spécifiés qui effectuent l’action spécifiée lorsque l’utilisateur ToolStripMenuItem clique dessus.

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

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)

Paramètres

text

String

Texte à afficher sur l’élément de menu.

image

Image

À Image afficher sur le contrôle.

onClick

EventHandler

Gestionnaire d’événements qui déclenche l’événement Click lorsque le contrôle est cliqué.

name

String

Nom de l’élément de menu.

Exemples

L’exemple de code suivant illustre une utilisation du ToolStripMenuItem constructeur.

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

Source:

ToolStripMenuItem.cs

Initialise une nouvelle instance de la ToolStripMenuItem classe qui affiche le texte et l’image spécifiés, effectue l’action spécifiée lorsque le ToolStripMenuItem clic est fait et affiche les touches de raccourci spécifiées.

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

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)

Paramètres

text

String

Texte à afficher sur l’élément de menu.

image

Image

À Image afficher sur le contrôle.

onClick

EventHandler

Gestionnaire d’événements qui déclenche l’événement Click lorsque le contrôle est cliqué.

shortcutKeys

Keys

L’une des valeurs de Keys ce qui représente la touche de raccourci pour le ToolStripMenuItem.

Remarques

Utilisez le ToolStripMenuItem constructeur pour créer un ToolStripMenuItem texte qui affiche du texte et une image, effectue l’action spécifiée lorsque vous cliquez dessus et dispose de la touche de raccourci spécifiée.