MenuItem Classe

Définition

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

Exemples

L’exemple de code suivant crée une structure de menus 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 sélectionner une taille de police, puis ajoute deux éléments de sous-menu à cet élément de menu qui représentent des choix de polices de grande taille et de petite taille dans une application. L’exemple requiert l’existence d’un MainMenu objet nommé mainMenu1 et de quatre MenuItem objets nommés menuItem1 , menuItem2 , menuItem3 et 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 MenuItem que vous puissiez afficher un, vous devez l’ajouter à un MainMenu ou un 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 coche 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 qui est sélectionné dans une liste d’éléments de menu qui s’excluent mutuellement. Par exemple, si vous disposez d’un ensemble d’éléments de menu pour définir la couleur du texte d’un TextBox contrôle, vous pouvez utiliser la Checked propriété pour identifier la couleur actuellement sélectionnée. La Shortcut propriété peut être utilisée pour définir une combinaison de touches qui peut être appuyée pour sélectionner l’élément de menu.

Pour les MenuItem objets affichés dans une application d’interface multidocument (MDI, multiple document interface), vous pouvez utiliser la MergeMenu méthode pour fusionner les menus d’un MDI parent avec ceux 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é dans 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 en vue de son utilisation dans un autre emplacement.

L' Popup événement 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' Select événement vous permet d’effectuer des tâches telles que fournir 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 à

Voir aussi