MenuItem Constructeurs

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Initialise une nouvelle instance de la classe MenuItem.

Surcharges

MenuItem()	Initialise MenuItem avec une légende vide.
MenuItem(String)	Initialise une nouvelle instance de la classe MenuItem avec une légende spécifiée pour l'élément de menu.
MenuItem(String, EventHandler)	Initialise une nouvelle instance de la classe avec une légende spécifiée et un gestionnaire d'événements pour l'événement Click de l'élément de menu.
MenuItem(String, MenuItem[])	Initialise une nouvelle instance de la classe avec une légende spécifiée et un tableau d'éléments de sous-menu définis pour l'élément de menu.
MenuItem(String, EventHandler, Shortcut)	Initialise une nouvelle instance de la classe avec une légende spécifiée, un gestionnaire d'événements et une touche de raccourci pour l'élément de menu.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Initialise une nouvelle instance de la classe MenuItem avec une légende spécifiée, des gestionnaires d'événements pour Click, Select et Popup, une touche de raccourci, un type de fusion et un ordre de fusion pour l'élément de menu.

MenuItem()

Initialise MenuItem avec une légende vide.

public:
 MenuItem();

public MenuItem ();

Public Sub New ()

Exemples

L’exemple de code suivant crée un MenuItem à l’aide de cette version du constructeur.

public:
   void CreateMyMenu()
   {
      // Create an empty menu item object.
      MenuItem^ menuItem1 = gcnew MenuItem;
      // Intialize the menu item using the parameterless version of the constructor.
      // Set the caption of the menu item.
      menuItem1->Text = "&File";
   }

public void CreateMyMenu()
{
   // Create an empty menu item object.
   MenuItem menuItem1 = new MenuItem();
   // Intialize the menu item using the parameterless version of the constructor.
   // Set the caption of the menu item.
   menuItem1.Text = "&File";
}

Public Sub CreateMyMenu()
    ' Create an empty menu item object.
    Dim menuItem1 As New MenuItem()
    ' Intialize the menu item using the parameterless version of the constructor.
    ' Set the caption of the menu item.
    menuItem1.Text = "&File"
End Sub

Remarques

Une fois que vous avez créé un vide MenuItem à l’aide de ce constructeur, vous pouvez utiliser les propriétés et les méthodes de la MenuItem classe pour spécifier l’apparence et le comportement de votre MenuItem.

MenuItem(String)

Initialise une nouvelle instance de la classe MenuItem avec une légende spécifiée pour l'élément de menu.

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

public MenuItem (string text);

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

Public Sub New (text As String)

Paramètres

text

String

Légende de l'élément de menu.

Exemples

L’exemple de code suivant crée un MenuItem qui spécifie le légende de l’élément de menu au moment de sa construction.

public:
   void CreateMyMenus()
   {
      // Create an instance of a MenuItem with a specified caption.
      menuItem1 = gcnew MenuItem( "&File" );
   }

public void CreateMyMenus()
{
   // Create an instance of a MenuItem with a specified caption.
   menuItem1 = new MenuItem("&File");
}

Public Sub CreateMyMenus()
    ' Create an instance of a MenuItem with a specified caption.
    menuItem1 = New MenuItem("&File")
End Sub

Remarques

Lorsque vous spécifiez une légende pour votre élément de menu avec le text paramètre, vous pouvez également spécifier une clé d’accès en plaçant un caractère « & » avant le caractère à utiliser comme clé d’accès. Par exemple, pour spécifier le « F » dans « Fichier » comme clé d’accès, vous devez spécifier le légende pour l’élément de menu « &Fichier ». Vous pouvez utiliser cette fonctionnalité pour fournir une navigation au clavier pour vos menus.

La définition du text paramètre sur «- » entraîne l’affichage de votre élément de menu en tant que séparateur (ligne horizontale) plutôt qu’en tant qu’élément de menu standard.

MenuItem(String, EventHandler)

Initialise une nouvelle instance de la classe avec une légende spécifiée et un gestionnaire d'événements pour l'événement Click de l'élément de menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick);

public MenuItem (string text, EventHandler onClick);

new System.Windows.Forms.MenuItem : string * EventHandler -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler)

Paramètres

text

String

Légende de l'élément de menu.

onClick

EventHandler

EventHandler qui gère l'événement Click pour cet élément de menu.

Exemples

L’exemple de code suivant crée un MenuItem objet avec un légende spécifié et un EventHandler délégué connecté à un gestionnaire d’événements qui gérera l’événement Click pour l’élément de menu.

public:
   void CreateMyMenuItem()
   {
      // Create an instance of MenuItem with caption and an event handler
      MenuItem^ menuItem1 = gcnew MenuItem( "&New",gcnew System::EventHandler(
         this, &Form1::MenuItem1_Click ) );
   }

private:
   // This method is an event handler for menuItem1 to use when connecting its event handler.
   void MenuItem1_Click( Object^ sender, System::EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create an instance of MenuItem with caption and an event handler
   MenuItem menuItem1 = new MenuItem("&New", new System.EventHandler(this.MenuItem1_Click));
}

// This method is an event handler for menuItem1 to use when connecting its event handler.
private void MenuItem1_Click(Object sender, System.EventArgs e) 
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create an instance of MenuItem with caption and an event 
    ' handler
    Dim MenuItem1 As New MenuItem("&New", New _
        System.EventHandler(AddressOf Me.MenuItem1_Click))
End Sub
' This method is an event handler for MenuItem1 to use when 
' connecting its event handler.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal _
    e as System.EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Remarques

Lorsque vous spécifiez une légende pour votre élément de menu avec le text paramètre, vous pouvez également spécifier une clé d’accès en plaçant un « & » avant le caractère à utiliser comme clé d’accès. Par exemple, pour spécifier le « F » dans « Fichier » comme clé d’accès, vous devez spécifier le légende pour l’élément de menu « &Fichier ». Vous pouvez utiliser cette fonctionnalité pour fournir une navigation au clavier pour vos menus.

La définition du text paramètre sur «- » entraîne l’affichage de votre élément de menu en tant que séparateur (ligne horizontale) plutôt qu’en tant qu’élément de menu standard.

En outre, vous pouvez utiliser ce constructeur pour spécifier un délégué qui gérera l’événement pour l’élément Click de menu en cours de création. Le EventHandler que vous passez à ce constructeur doit être configuré pour appeler un gestionnaire d’événements qui peut gérer l’événement Click . Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.

MenuItem(String, MenuItem[])

Initialise une nouvelle instance de la classe avec une légende spécifiée et un tableau d'éléments de sous-menu définis pour l'élément de menu.

public:
 MenuItem(System::String ^ text, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (string text, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (text As String, items As MenuItem())

Paramètres

text

String

Légende de l'élément de menu.

items

MenuItem[]

Tableau d'objets MenuItem qui contient les éléments de sous-menu de cet élément de menu.

Exemples

L’exemple de code suivant crée un objet avec un légende spécifié, un gestionnaire d’événements connecté à une méthode qui gère l’événement chaque élément de menu dans un tableau d’éléments de sous-menu.

public:
   void CreateMyMenuItem()
   {
      // submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      // Create an instance of a MenuItem with caption and an array of submenu
      // items specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&Colors",subMenus );
   }

public void CreateMyMenuItem()
{
   // submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");
   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   // Create an instance of a MenuItem with caption and an array of submenu
   // items specified.
   MenuItem MenuItem1 = new MenuItem("&Colors", subMenus);
}

Public Sub CreateMyMenuItem()
    ' submenu item array.
    Dim subMenus(3) As MenuItem
    ' Create three menu items to add to the submenu item array.
    Dim subMenuItem1 As New MenuItem("Red")
    Dim subMenuItem2 As New MenuItem("Blue")
    Dim subMenuItem3 As New MenuItem("Green")
    ' Add the submenu items to the array.
    subMenus(0) = subMenuItem1
    subMenus(1) = subMenuItem2
    subMenus(2) = subMenuItem3
    ' Create an instance of a MenuItem with caption and an array of submenu
    ' items specified.
    Dim MenuItem1 As New MenuItem("&Colors", subMenus)
End Sub

Remarques

Lorsque vous spécifiez une légende pour votre élément de menu avec le text paramètre, vous pouvez également spécifier une clé d’accès en plaçant un « & » avant le caractère à utiliser comme clé d’accès. Par exemple, pour spécifier le « F » dans « Fichier » comme clé d’accès, vous devez spécifier le légende pour l’élément de menu « &Fichier ». Vous pouvez utiliser cette fonctionnalité pour fournir une navigation au clavier pour vos menus.

La définition du text paramètre sur «- » entraîne l’affichage de votre élément de menu en tant que séparateur (ligne horizontale) plutôt qu’en tant qu’élément de menu standard.

Le items paramètre vous permet d’affecter un tableau d’éléments de menu pour définir un sous-menu de cet élément de menu. Un tableau d’éléments de menu peut également être affecté à chaque élément du tableau. Cela vous permet de créer des structures de menu complètes et de les affecter au constructeur de l’élément de menu.

Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.

MenuItem(String, EventHandler, Shortcut)

Initialise une nouvelle instance de la classe avec une légende spécifiée, un gestionnaire d'événements et une touche de raccourci pour l'élément de menu.

public:
 MenuItem(System::String ^ text, EventHandler ^ onClick, System::Windows::Forms::Shortcut shortcut);

public MenuItem (string text, EventHandler onClick, System.Windows.Forms.Shortcut shortcut);

new System.Windows.Forms.MenuItem : string * EventHandler * System.Windows.Forms.Shortcut -> System.Windows.Forms.MenuItem

Public Sub New (text As String, onClick As EventHandler, shortcut As Shortcut)

Paramètres

text

String

Légende de l'élément de menu.

onClick

EventHandler

EventHandler qui gère l'événement Click pour cet élément de menu.

shortcut

Shortcut

Une des valeurs de l'objet Shortcut.

Exemples

L’exemple de code suivant crée un objet avec un légende, une touche de raccourci et un gestionnaire d’événements spécifiés connectés à une méthode qui gère l’événement pour l’élément de menu.

public:
   void CreateMyMenuItem()
   {
      // Create a MenuItem with caption, shortcut key, and an event handler
      // specified.
      MenuItem^ MenuItem1 = gcnew MenuItem( "&New",
         gcnew System::EventHandler( this, &Form1::MenuItem1_Click ), Shortcut::CtrlL );
   }

private:
   // The following method is an event handler for menuItem1 to use when
   // connecting the event handler.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Create a MenuItem with caption, shortcut key, and an event handler
   // specified.
   MenuItem MenuItem1 = new MenuItem("&New",
       new System.EventHandler(this.MenuItem1_Click), Shortcut.CtrlL);
}

// The following method is an event handler for menuItem1 to use when
// connecting the event handler.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
    ' Create a MenuItem with caption, shortcut key, and an event handler
    ' specified.
    Dim MenuItem1 As New MenuItem("&New", _
       New System.EventHandler(AddressOf Me.MenuItem1_Click), Shortcut.CtrlL)
End Sub    
   
' The following method is an event handler for menuItem1 to use when
' connecting the event handler.
Private Sub MenuItem1_Click(sender As Object, e As EventArgs)
    ' Code goes here that handles the Click event.
End Sub

Remarques

Lorsque vous spécifiez une légende pour votre élément de menu avec le text paramètre, vous pouvez également spécifier une clé d’accès en plaçant un « & » avant le caractère à utiliser comme clé d’accès. Par exemple, pour spécifier le « F » dans « Fichier » comme clé d’accès, vous devez spécifier le légende pour l’élément de menu « &Fichier ». Vous pouvez utiliser cette fonctionnalité pour fournir une navigation au clavier pour vos menus. Ce constructeur vous permet également de spécifier une touche de raccourci en plus d’une touche d’accès pour fournir la navigation au clavier. Les touches de raccourci vous permettent de spécifier une combinaison de touches qui peuvent être utilisées pour activer l’élément de menu.

La définition du text paramètre sur «- » entraîne l’affichage de votre élément de menu en tant que séparateur (ligne horizontale) plutôt qu’en tant qu’élément de menu standard.

En outre, vous pouvez utiliser ce constructeur pour spécifier un délégué qui gérera l’événement pour l’élément Click de menu en cours de création. Le EventHandler que vous passez à ce constructeur doit être configuré pour appeler un gestionnaire d’événements qui peut gérer l’événement Click . Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.

MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Initialise une nouvelle instance de la classe MenuItem avec une légende spécifiée, des gestionnaires d'événements pour Click, Select et Popup, une touche de raccourci, un type de fusion et un ordre de fusion pour l'élément de menu.

public:
 MenuItem(System::Windows::Forms::MenuMerge mergeType, int mergeOrder, System::Windows::Forms::Shortcut shortcut, System::String ^ text, EventHandler ^ onClick, EventHandler ^ onPopup, EventHandler ^ onSelect, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public MenuItem (System.Windows.Forms.MenuMerge mergeType, int mergeOrder, System.Windows.Forms.Shortcut shortcut, string text, EventHandler onClick, EventHandler onPopup, EventHandler onSelect, System.Windows.Forms.MenuItem[] items);

new System.Windows.Forms.MenuItem : System.Windows.Forms.MenuMerge * int * System.Windows.Forms.Shortcut * string * EventHandler * EventHandler * EventHandler * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Sub New (mergeType As MenuMerge, mergeOrder As Integer, shortcut As Shortcut, text As String, onClick As EventHandler, onPopup As EventHandler, onSelect As EventHandler, items As MenuItem())

Paramètres

mergeType

MenuMerge

Une des valeurs de l'objet MenuMerge.

mergeOrder

Int32

Position relative occupée par cet élément de menu dans un menu fusionné.

shortcut

Shortcut

Une des valeurs de l'objet Shortcut.

text

String

Légende de l'élément de menu.

onClick

EventHandler

EventHandler qui gère l'événement Click pour cet élément de menu.

onPopup

EventHandler

EventHandler qui gère l'événement Popup pour cet élément de menu.

onSelect

EventHandler

EventHandler qui gère l'événement Select pour cet élément de menu.

items

MenuItem[]

Tableau d'objets MenuItem qui contient les éléments de sous-menu de cet élément de menu.

Exemples

L’exemple de code suivant crée un élément de menu doté d’une légende et d’une touche de raccourci. L’élément de menu a également des gestionnaires d’événements définis pour les Popupévénements , Clicket Select . Si cet élément de menu est fusionné, il ajoute l’élément de menu au menu avec l’ordre de fusion de zéro.

public:
   void CreateMyMenuItem()
   {
      // Submenu item array.
      array<MenuItem^>^ subMenus = gcnew array<MenuItem^>(3);
      // Create three menu items to add to the submenu item array.
      MenuItem^ subMenuItem1 = gcnew MenuItem( "Red" );
      MenuItem^ subMenuItem2 = gcnew MenuItem( "Blue" );
      MenuItem^ subMenuItem3 = gcnew MenuItem( "Green" );
      
      // Add the submenu items to the array.
      subMenus[ 0 ] = subMenuItem1;
      subMenus[ 1 ] = subMenuItem2;
      subMenus[ 2 ] = subMenuItem3;
      /* Create a MenuItem with caption, shortcut key, 
         a Click, Popup, and Select event handler, merge type and order, and an 
         array of submenu items specified.
      */
      MenuItem^ menuItem1 = gcnew MenuItem( MenuMerge::Add, 0,
         Shortcut::CtrlShiftC, "&Colors",
         gcnew EventHandler( this, &Form1::MenuItem1_Click ),
         gcnew EventHandler( this, &Form1::MenuItem1_Popup ),
         gcnew EventHandler( this, &Form1::MenuItem1_Select ), subMenus );
   }

private:
   // The following method is an event handler for menuItem1 to use when connecting the Click event.
   void MenuItem1_Click( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Popup event.
   void MenuItem1_Popup( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

   // The following method is an event handler for menuItem1 to use  when connecting the Select event
   void MenuItem1_Select( Object^ sender, EventArgs^ e )
   {
      // Code goes here that handles the Click event.
   }

public void CreateMyMenuItem()
{
   // Submenu item array.
   MenuItem[] subMenus = new MenuItem[3];
   // Create three menu items to add to the submenu item array.
   MenuItem subMenuItem1 = new MenuItem("Red");
   MenuItem subMenuItem2 = new MenuItem("Blue");
   MenuItem subMenuItem3 = new MenuItem("Green");

   // Add the submenu items to the array.
   subMenus[0] = subMenuItem1;
   subMenus[1] = subMenuItem2;
   subMenus[2] = subMenuItem3;
   /* Create a MenuItem with caption, shortcut key, 
      a Click, Popup, and Select event handler, merge type and order, and an 
      array of submenu items specified.
   */
   MenuItem menuItem1 = new MenuItem(MenuMerge.Add, 0,
      Shortcut.CtrlShiftC, "&Colors", 
      new EventHandler(this.MenuItem1_Click),
      new EventHandler(this.MenuItem1_Popup),
      new EventHandler(this.MenuItem1_Select), subMenus);
}

// The following method is an event handler for menuItem1 to use when connecting the Click event.
private void MenuItem1_Click(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Popup event.
private void MenuItem1_Popup(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

// The following method is an event handler for menuItem1 to use  when connecting the Select event
private void MenuItem1_Select(Object sender, EventArgs e)
{
   // Code goes here that handles the Click event.
}

Public Sub CreateMyMenuItem()
   ' Submenu item array.
   Dim SubMenus(3) as MenuItem
   ' Create three menu items to add to the submenu item array.
   Dim SubMenuItem1, SubMenuItem2, SubMenuItem3 as MenuItem
   SubMenuItem1 = New MenuItem ("Red")
   SubMenuItem2 = New MenuItem ("Blue")
   SubMenuItem3 = New MenuItem ("Green")
   ' Add the submenu items to the array.
   SubMenus(0) = SubMenuItem1
   SubMenus(1) = SubMenuItem2
   SubMenus(2) = SubMenuItem3
   ' Create a MenuItem with caption, shortcut key, 
   ' a Click, Popup, and Select event handler, menu merge type and order, and an 
   ' array of submenu items specified.
   Dim MenuItem1 As MenuItem
   MenuItem1 = New MenuItem(MenuMerge.Add, 0, Shortcut.CtrlShiftC, "&Colors", _
      AddressOf Me.MenuItem1_Click, _
      AddressOf Me.MenuItem1_Popup, _
      AddressOf Me.MenuItem1_Select, SubMenus)
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Click event.
Private Sub MenuItem1_Click(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Popup event.
Private Sub MenuItem1_Popup(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

' The following method is an event handler for MenuItem1 to use  when connecting the Select event
Private Sub MenuItem1_Select(ByVal sender As System.Object, ByVal  e as System.EventArgs)
   ' Code goes here that handles the Click event.
End Sub

Remarques

Lorsque vous spécifiez une légende pour votre élément de menu avec le text paramètre, vous pouvez également spécifier une clé d’accès en plaçant un « & » avant le caractère à utiliser comme clé d’accès. Par exemple, pour spécifier le « F » dans « Fichier » comme clé d’accès, vous devez spécifier le légende pour l’élément de menu « &Fichier ». Vous pouvez utiliser cette fonctionnalité pour fournir une navigation au clavier pour vos menus.

La définition du text paramètre sur «- » entraîne l’affichage de votre élément de menu en tant que séparateur (ligne horizontale) plutôt qu’en tant qu’élément de menu standard.

Le items paramètre vous permet d’affecter un tableau d’éléments de menu pour définir un sous-menu de cet élément de menu. Un tableau d’éléments de menu peut également être affecté à chaque élément du tableau. Cela vous permet de créer des structures de menu complètes et de les affecter au constructeur de l’élément de menu.

Les mergeType paramètres et mergeOrder vous permettent de déterminer le comportement de cet élément de menu lorsque l’élément de menu est fusionné avec un autre menu. Selon la valeur que vous spécifiez pour le mergeType paramètre, vous pouvez ajouter, supprimer, remplacer ou fusionner l’élément de menu et ses éléments de sous-menu avec le menu avec lequel il fusionne. Le mergeOrder paramètre détermine l’emplacement de l’élément de menu en cours de création lors de la fusion du menu.

En outre, vous pouvez utiliser ce constructeur pour créer un MenuItem et le connecter à un gestionnaire d’événements dans votre code qui traitera le clic de l’élément de menu. Le EventHandler que vous passez à ce constructeur doit être configuré pour appeler un gestionnaire d’événements capable de gérer l’événement Click . En utilisant cette version du constructeur, vous pouvez également connecter les Popup événements et Select pour déterminer quand cet élément de menu est sélectionné. Vous pouvez utiliser ces événements pour des tâches telles que la détermination de l’affichage d’une marque case activée en regard des éléments du sous-menu ou pour activer ou désactiver les éléments de menu en fonction de l’état de l’application. Les Select événements et Click sont déclenchés uniquement pour les MenuItem objets qui ne sont pas des éléments de menu parent. Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.

Voir aussi

• Popup
• Select
• Click
• MergeType
• MergeOrder