MenuItem Classe

Définition

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Héritage

Object

MarshalByRefObject

Component

Menu

MenuItem

Exemples

L’exemple de code suivant crée une structure de menu pour un formulaire. L’exemple de code ajoute un MenuItem pour représenter l’élément de menu de niveau supérieur, y ajoute un élément de sous-menu pour la sélection d’une taille de police, puis ajoute deux éléments de sous-menu à cet élément de menu qui représentent des choix de polices grands et petits dans une application. L’exemple nécessite qu’il existe un MainMenu objet nommé mainMenu1 et quatre MenuItem objets nommés menuItem1, menuItem2, menuItem3et menuItem4.

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Remarques

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez plutôt ToolStripMenuItem.

Pour qu’un MenuItem s’affiche, vous devez l’ajouter à un MainMenu ou ContextMenu. Pour créer des sous-menus, vous pouvez ajouter MenuItem des objets à la MenuItems propriété du parent MenuItem.

La MenuItem classe fournit des propriétés qui vous permettent de configurer l’apparence et les fonctionnalités d’un élément de menu. Pour afficher une marque de case activée en regard d’un élément de menu, utilisez la Checked propriété . Vous pouvez utiliser cette fonctionnalité pour identifier un élément de menu sélectionné dans une liste d’éléments de menu mutuellement exclusifs. Par exemple, si vous disposez d’un ensemble d’éléments de menu pour définir la couleur du texte dans un TextBox contrôle, vous pouvez utiliser la propriété pour identifier la Checked couleur actuellement sélectionnée. La Shortcut propriété peut être utilisée pour définir une combinaison de clavier sur laquelle vous pouvez appuyer pour sélectionner l’élément de menu.

Pour MenuItem les objets affichés dans une application MDI (Multiple Document Interface), vous pouvez utiliser la MergeMenu méthode pour fusionner les menus d’un parent MDI avec celui de ses formulaires enfants afin de créer une structure de menu consolidée. Étant donné qu’un MenuItem ne peut pas être réutilisé à plusieurs emplacements en même temps, par exemple dans un MainMenu et un ContextMenu, vous pouvez utiliser la CloneMenu méthode pour créer une copie d’un MenuItem pour une utilisation dans un autre emplacement.

L’événement Popup vous permet d’effectuer des tâches avant l’affichage d’un menu. Par exemple, vous pouvez créer un gestionnaire d’événements pour cet événement afin d’afficher ou de masquer les éléments de menu en fonction de l’état de votre code. L’événement Select vous permet d’effectuer des tâches telles que la fourniture d’une aide détaillée pour les éléments de menu de votre application lorsque l’utilisateur place le pointeur de la souris sur un élément de menu.

Constructeurs

Champs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• MainMenu
• Menu
• MenuMerge
• ContextMenu