MenuItem Classe

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: MenuItem.cs

Source:: MenuItem.cs

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.

Attention

Menu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStripDropDown and ToolStripDropDownMenu instead.

Représente un élément individuel affiché dans un MainMenu ou 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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Héritage: Object

MarshalByRefObject

Component

Menu
MenuItem

Attributs: BrowsableAttribute ObsoleteAttribute

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, ajoute un sous-menu à celui-ci 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 volumineux et petits dans une application. L’exemple nécessite qu’il existe un MainMenu objet nommé mainMenu1 et quatre MenuItem objets nommés menuItem1, , menuItem3menuItem2et 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 ToolStripMenuItem à la place.

Pour qu’un MenuItem élément soit affiché, vous devez l’ajouter à un MainMenu ou ContextMenu. Pour créer des sous-menus, vous pouvez ajouter des MenuItem 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 sélectionné dans une liste d’éléments de menu mutuellement exclusifs. Par exemple, si vous avez un ensemble d’éléments de menu pour définir la couleur du texte dans 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 clavier qui peut être enfoncée 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 pour celui de ses formulaires enfants afin de créer une structure de menu consolidée. Étant donné qu’il MenuItem ne peut pas être réutilisé dans plusieurs emplacements en même temps, comme dans un MainMenu et un ContextMenu, vous pouvez utiliser la CloneMenu méthode pour créer une copie d’un MenuItem emplacement à utiliser 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’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

Nom	Description
MenuItem()	Obsolète. Initialise une MenuItem légende vide.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Obsolète. Initialise une nouvelle instance de la MenuItem classe avec une légende spécifiée ; des gestionnaires d’événements définis pour le Click, Select et Popup les événements ; une touche de raccourci ; un type de fusion ; et l’ordre spécifié pour l’élément de menu.
MenuItem(String, EventHandler, Shortcut)	Obsolète. Initialise une nouvelle instance de la classe avec une légende, un gestionnaire d’événements et une touche de raccourci associée pour l’élément de menu.
MenuItem(String, EventHandler)	Obsolète. Initialise une nouvelle instance de la classe avec une légende et un gestionnaire d’événements spécifiés pour l’événement de l’élément Click de menu.
MenuItem(String, MenuItem[])	Obsolète. 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)	Obsolète. Initialise une nouvelle instance de la MenuItem classe avec une légende spécifiée pour l’élément de menu.

Champs

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

Propriétés

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

Méthodes

Nom	Description
CloneMenu()	Obsolète. Crée une copie du MenuItemactuel .
CloneMenu(Menu)	Obsolète. Copie l’objet Menu passé en tant que paramètre à l’état actuel Menu. (Hérité de Menu)
CloneMenu(MenuItem)	Obsolète. Crée une copie du fichier spécifié MenuItem.
CreateMenuHandle()	Obsolète. Crée un handle pour le Menu. (Hérité de Menu)
CreateObjRef(Type)	Obsolète. Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Obsolète. Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Obsolète. Supprime les ressources (autres que la mémoire) utilisées par le MenuItem.
Equals(Object)	Obsolète. Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindMenuItem(Int32, IntPtr)	Obsolète. Obtient la MenuItem valeur spécifiée. (Hérité de Menu)
FindMergePosition(Int32)	Obsolète. Retourne la position à laquelle un élément de menu doit être inséré dans le menu. (Hérité de Menu)
GetContextMenu()	Obsolète. Obtient le ContextMenu menu qui contient ce menu. (Hérité de Menu)
GetHashCode()	Obsolète. Sert 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 actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMainMenu()	Obsolète. Obtient le MainMenu menu qui contient ce menu. (Hérité de Menu)
GetService(Type)	Obsolète. Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obsolète. Obtient la 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()	Obsolète. Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Obsolète. Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
MergeMenu()	Obsolète. Fusionne cette opération MenuItem avec une autre MenuItem et retourne la fusion résultante MenuItem.
MergeMenu(Menu)	Obsolète. Fusionne les MenuItem objets d’un menu avec le menu actif. (Hérité de Menu)
MergeMenu(MenuItem)	Obsolète. Fusionne un autre élément de menu avec cet élément de menu.
OnClick(EventArgs)	Obsolète. Déclenche l’événement Click.
OnDrawItem(DrawItemEventArgs)	Obsolète. Déclenche l’événement DrawItem.
OnInitMenuPopup(EventArgs)	Obsolète. Déclenche l’événement Popup.
OnMeasureItem(MeasureItemEventArgs)	Obsolète. Déclenche l’événement MeasureItem.
OnPopup(EventArgs)	Obsolète. Déclenche l’événement Popup.
OnSelect(EventArgs)	Obsolète. Déclenche l’événement Select.
PerformClick()	Obsolète. Génère un Click événement pour le MenuItem, simulant un clic par un utilisateur.
PerformSelect()	Obsolète. Déclenche l’événement Select pour cet élément de menu.
ProcessCmdKey(Message, Keys)	Obsolète. Traite une clé de commande. (Hérité de Menu)
ToString()	Obsolète. Retourne une chaîne qui représente le MenuItem.

Événements

Nom	Description
Click	Obsolète. Se produit lorsque l’élément de menu est cliqué ou sélectionné à l’aide d’une touche de raccourci ou d’une touche d’accès définie pour l’élément de menu.
Disposed	Obsolète. Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)
DrawItem	Obsolète. Se produit lorsque la OwnerDraw propriété d’un élément de menu est définie `true` et qu’une demande est effectuée pour dessiner l’élément de menu.
MeasureItem	Obsolète. Se produit lorsque le menu doit connaître la taille d’un élément de menu avant de le dessiner.
Popup	Obsolète. Se produit avant l’affichage de la liste des éléments de menu d’un élément de menu.
Select	Obsolète. Se produit lorsque l’utilisateur place le pointeur sur un élément de menu.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?