MenuItem Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un élément affiché dans MainMenu ou dans ContextMenu.

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez ToolStripMenuItem à la place, ce qui remplace le MenuItem contrôle.

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

MenuItem()	Initialise MenuItem avec une légende vide.
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(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, 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(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.

Champs

FindHandle	Spécifie que la méthode FindMenuItem(Int32, IntPtr) doit rechercher un handle. (Hérité de Menu)
FindShortcut	Spécifie que la méthode FindMenuItem(Int32, IntPtr) doit rechercher un raccourci. (Hérité de Menu)

Propriétés

BarBreak	Obtient ou définit une valeur qui indique si MenuItem est placé sur une nouvelle ligne (pour un élément de menu ajouté à un objet MainMenu) ou dans une nouvelle colonne (pour un élément de sous-menu ou un élément de menu affiché dans ContextMenu).
Break	Obtient ou définit une valeur qui indique si l'élément est placé sur une nouvelle ligne (pour un élément de menu ajouté à un objet MainMenu) ou dans une nouvelle colonne (pour un élément de menu ou un élément de sous-menu affiché dans ContextMenu).
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Checked	Obtient ou définit une valeur qui indique si une coche apparaît en regard du texte de l'élément de menu.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DefaultItem	Obtient ou définit une valeur indiquant si l'élément est l'élément de menu par défaut.
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Enabled	Obtient ou définit une valeur qui indique si l'élément de menu est activé.
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
Handle	Obtient une valeur qui représente le handle de fenêtre pour le menu. (Hérité de Menu)
Index	Obtient ou définit une valeur qui indique la position de l'élément de menu dans son menu parent.
IsParent	Obtient une valeur qui indique si l'élément de menu contient des éléments de menu enfants.
MdiList	Obtient ou définit une valeur qui indique si l'élément de menu va être rempli avec la liste des fenêtres enfants MDI (interface multidocument) affichées dans le formulaire associé.
MdiListItem	Obtient une valeur indiquant le MenuItem utilisé pour afficher une liste de formulaires enfants MDI. (Hérité de Menu)
MenuID	Obtient une valeur qui indique l'identificateur Windows pour cet élément de menu.
MenuItems	Obtient une valeur qui indique la collection d'objets MenuItem associée au menu. (Hérité de Menu)
MergeOrder	Obtient ou définit une valeur qui indique la position relative de l’élément de menu lorsqu’il est fusionné avec un autre.
MergeType	Obtient ou définit une valeur qui indique le comportement de l’élément de menu lorsque son menu est fusionné avec un autre.
Mnemonic	Obtient une valeur qui indique le caractère mnémonique associé à cet élément de menu.
Name	Obtient ou définit le nom de l'objet Menu. (Hérité de Menu)
OwnerDraw	Obtient ou définit une valeur qui indique si l'élément de menu est dessiné par le code que vous fournissez ou par Windows.
Parent	Obtient une valeur indiquant le menu qui contient cet élément de menu.
RadioCheck	Obtient ou définit une valeur qui indique si le MenuItem affiche une case d'option au lieu d'une coche lorsqu'il est activé.
Shortcut	Obtient ou définit une valeur qui indique la touche de raccourci associée à l'élément de menu.
ShowShortcut	Obtient ou définit une valeur qui indique si la touche de raccourci associée à l'élément de menu est affichée en regard de la légende de l'élément de menu.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
Tag	Obtient ou définit les données définies par l'utilisateur associées au contrôle. (Hérité de Menu)
Text	Obtient ou définit une valeur qui indique la légende de l'élément de menu.
Visible	Obtient ou définit une valeur qui indique si l'élément de menu est visible.

Méthodes

CloneMenu()	Crée une copie de l'élément MenuItem actuel.
CloneMenu(Menu)	Copie le Menu qui est passé comme paramètre au Menu en cours. (Hérité de Menu)
CloneMenu(MenuItem)	Crée une copie du MenuItem spécifié.
CreateMenuHandle()	Crée un nouveau handle pour Menu. (Hérité de Menu)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources (autres que la mémoire) utilisées par MenuItem.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindMenuItem(Int32, IntPtr)	Obtient le MenuItem qui contient la valeur spécifiée. (Hérité de Menu)
FindMergePosition(Int32)	Retourne la position à laquelle un élément de menu doit être inséré dans le menu. (Hérité de Menu)
GetContextMenu()	Obtient le ContextMenu qui contient ce menu. (Hérité de Menu)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMainMenu()	Obtient le MainMenu qui contient ce menu. (Hérité de Menu)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
MergeMenu()	Fusionne ce MenuItem avec un autre MenuItem et retourne le MenuItem qui résulte de la fusion.
MergeMenu(Menu)	Fusionne les objets MenuItem d'un menu avec le menu en cours. (Hérité de Menu)
MergeMenu(MenuItem)	Fusionne un autre élément de menu avec cet élément.
OnClick(EventArgs)	Déclenche l’événement Click.
OnDrawItem(DrawItemEventArgs)	Déclenche l’événement DrawItem.
OnInitMenuPopup(EventArgs)	Déclenche l’événement Popup.
OnMeasureItem(MeasureItemEventArgs)	Déclenche l’événement MeasureItem.
OnPopup(EventArgs)	Déclenche l’événement Popup.
OnSelect(EventArgs)	Déclenche l’événement Select.
PerformClick()	Génère un événement Click pour MenuItem, ce qui simule un clic de l'utilisateur.
PerformSelect()	Déclenche l'événement Select pour cet élément de menu.
ProcessCmdKey(Message, Keys)	Traite une touche de commande. (Hérité de Menu)
ToString()	Retourne une chaîne qui représente MenuItem.

Événements

Click	Se produit suite à un clic sur l'élément de menu ou à la sélection de cet élément à l'aide d'une touche de raccourci ou d'une touche d'accès rapide.
Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)
DrawItem	Se produit lorsque la propriété OwnerDraw d'un élément de menu a la valeur `true` et qu'une demande visant à dessiner l'élément de menu est faite.
MeasureItem	Se produit lorsque le menu a besoin de connaître la taille d'un élément de menu avant de le dessiner.
Popup	Se produit avant l'affichage de la liste des éléments de menu d'un élément de menu.
Select	Se produit lorsque l'utilisateur place le pointeur sur un élément de menu.

S’applique à

Partage via