MenuItem Constructeurs

Source:

MenuItem.cs

Source:

MenuItem.cs

public:
 MenuItem();

public MenuItem();

Public Sub New ()

Exemples

L’exemple de code suivant crée une MenuItem version 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 méthodes de la MenuItem classe pour spécifier l’apparence et le comportement de votre MenuItem.

Source:

MenuItem.cs

Source:

MenuItem.cs

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

Exemples

L’exemple de code suivant crée une MenuItem 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 que le caractère soit utilisé comme clé d’accès. Par exemple, pour spécifier « F » dans « Fichier » en tant que clé d’accès, vous devez spécifier la légende de l’élément de menu en tant que « &File ». 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’un élément de menu standard.

Source:

MenuItem.cs

Source:

MenuItem.cs

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

Exemples

L’exemple de code suivant crée un MenuItem objet avec une légende spécifiée et un EventHandler délégué connecté à un gestionnaire d’événements qui gère 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 que le caractère soit utilisé comme clé d’accès. Par exemple, pour spécifier « F » dans « Fichier » en tant que clé d’accès, vous devez spécifier la légende de l’élément de menu en tant que « &File ». 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’un élément de menu standard.

En outre, vous pouvez utiliser ce constructeur pour spécifier un délégué qui gère l’événement Click pour l’élément de menu en cours de création. Le EventHandler passage à 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.

Source:

MenuItem.cs

Source:

MenuItem.cs

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

Exemples

L’exemple de code suivant crée un objet avec une légende spécifiée, 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 que le caractère soit utilisé comme clé d’accès. Par exemple, pour spécifier « F » dans « Fichier » en tant que clé d’accès, vous devez spécifier la légende de l’élément de menu en tant que « &File ». 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’un élément de menu standard.

Le items paramètre vous permet d’attribuer un tableau d’éléments de menu pour définir un sous-menu de cet élément de menu. Chaque élément du tableau peut également avoir un tableau d’éléments de menu qui lui sont attribués. Cela vous permet de créer des structures de menu complètes et de les affecter au constructeur pour l’élément de menu.

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

Source:

MenuItem.cs

Source:

MenuItem.cs

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

Exemples

L’exemple de code suivant crée un objet avec une légende, une touche de raccourci et un gestionnaire d’événements connecté à 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 que le caractère soit utilisé comme clé d’accès. Par exemple, pour spécifier « F » dans « Fichier » en tant que clé d’accès, vous devez spécifier la légende de l’élément de menu en tant que « &File ». 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’un élément de menu standard.

En outre, vous pouvez utiliser ce constructeur pour spécifier un délégué qui gère l’événement Click pour l’élément de menu en cours de création. Le EventHandler passage à 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.

Source:

MenuItem.cs

Source:

MenuItem.cs

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

Exemples

L’exemple de code suivant crée un élément de menu qui a une légende et une touche de raccourci. L’élément de menu comporte également des gestionnaires d’événements définis pour les événements et PopupClick les Selectévénements. Si cet élément de menu est fusionné, il ajoute l’élément de menu au menu avec l’ordre de fusion 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 que le caractère soit utilisé comme clé d’accès. Par exemple, pour spécifier « F » dans « Fichier » en tant que clé d’accès, vous devez spécifier la légende de l’élément de menu en tant que « &File ». 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’un élément de menu standard.

Le items paramètre vous permet d’attribuer un tableau d’éléments de menu pour définir un sous-menu de cet élément de menu. Chaque élément du tableau peut également avoir un tableau d’éléments de menu qui lui sont attribués. Cela vous permet de créer des structures de menu complètes et de les affecter au constructeur pour l’élément de menu.

Les mergeType paramètres mergeOrder et les paramètres 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 sous-éléments avec le menu qu’il fusionne. Le mergeOrder paramètre détermine l’emplacement de création de l’élément de menu lorsque le menu est fusionné.

En outre, vous pouvez utiliser ce constructeur pour créer un MenuItem gestionnaire d’événements connecté à un gestionnaire d’événements dans votre code qui traitera le clic de l’élément de menu. Le EventHandler fait que vous transmettez à ce constructeur doit être configuré pour appeler un gestionnaire d’événements qui peut gérer l’événement Click . À l’aide de cette version du constructeur, vous pouvez également connecter les événements et Popup les Select événements pour déterminer quand cet élément de menu est sélectionné. Vous pouvez utiliser ces événements pour les tâches telles que la détermination de l’affichage ou non d’une coche en regard des sous-éléments ou pour activer ou désactiver des éléments de menu en fonction de l’état de l’application. Les Select événements et Click les événements sont déclenchés uniquement pour MenuItem les 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