Menu 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 les fonctionnalités de base pour tous les menus.

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez plutôt ToolStripDropDown et ToolStripDropDownMenu, qui remplacent et étendent le contrôle Menu.

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Héritage: Object

MarshalByRefObject

Component
Menu

Dérivé: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Attributs: ListBindableAttribute

Exemples

L’exemple de code suivant utilise la classe dérivée, MenuItempour créer une structure de menu pour un formulaire. L’exemple de code ajoute un MenuItem élément de menu de niveau supérieur, ajoute un élément de sous-menu pour sélectionner une taille de police, puis ajoute deux sous-menus à cet élément de menu qui représentent des choix de police 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, 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 ToolStripDropDown et ToolStripDropDownMenu.

Cette classe est la classe de base pour les MainMenuclasses , MenuItemet ContextMenu les classes. Vous ne pouvez pas créer une instance de cette classe. Les menus d’une application se composent d’objets MenuItem . Celles-ci peuvent contenir d’autres MenuItem objets, représentant des éléments de sous-menu. Les MenuItem objets peuvent être stockés dans un MainMenu menu complet pour un formulaire ou un ContextMenu menu utilisé pour afficher des menus contextuels. Cette classe fournit des fonctionnalités courantes pour toutes les classes de menu.

Contrairement à de nombreuses classes de base, la Menu classe utilise ses classes dérivées pour définir de nombreuses de ses propriétés. Si vous utilisez votre menu dans une application MDI (Multiple Document Interface), vous pouvez utiliser la MdiListItem propriété pour spécifier une MenuItem liste de formulaires enfants MDI ouverts dans votre application. La MenuItems propriété contient une liste d’objets MenuItem stockés dans la classe de menu. Pour un MainMenu ou ContextMenu, cette propriété contient tous les MenuItem objets affichés. Pour un MenuItem, la MenuItems propriété représente les sous-éléments associés à celui-ci.

Outre les propriétés fournies pour toutes les classes de menus dérivées, la Menu classe fournit également des méthodes, telles que CloneMenu et MergeMenu, qui vous permettent de créer de nouveaux menus à partir de menus existants, et de fusionner deux structures de menus ensemble.

La Menu classe définit également la classe Menu.MenuItemCollectionimbriquée . Cette classe définit la collection d’objets MenuItem utilisés par la MenuItems propriété. Vous pouvez utiliser les méthodes de la Menu.MenuItemCollection classe pour ajouter et supprimer des éléments de menu d’un MainMenu, ContextMenuou MenuItem.

Constructeurs

Menu(MenuItem[])

Initialise une nouvelle instance de la classe Menu.

Champs

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

Propriétés

CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
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.
IsParent	Obtient une valeur indiquant si ce menu contient des éléments de menu. Cette propriété est en lecture seule.
MdiListItem	Obtient une valeur indiquant le MenuItem utilisé pour afficher une liste de formulaires enfants MDI.
MenuItems	Obtient une valeur qui indique la collection d'objets MenuItem associée au menu.
Name	Obtient ou définit le nom de l'objet 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.

Méthodes

CloneMenu(Menu)	Copie le Menu qui est passé comme paramètre au Menu en cours.
CreateMenuHandle()	Crée un nouveau handle pour 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 Menu.
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.
FindMergePosition(Int32)	Retourne la position à laquelle un élément de menu doit être inséré dans le menu.
GetContextMenu()	Obtient le ContextMenu qui contient ce 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.
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(Menu)	Fusionne les objets MenuItem d'un menu avec le menu en cours.
ProcessCmdKey(Message, Keys)	Traite une touche de commande.
ToString()	Retourne une String qui représente le contrôle Menu.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)

S’applique à