Menu Classe

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: Menu.cs

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

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez ToolStripDropDown et ToolStripDropDownMenu , à la place, remplacez et étendez le Menu contrôle.

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

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

[System.ComponentModel.ListBindable(false)]
[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 abstract class Menu : System.ComponentModel.Component

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

[<System.ComponentModel.ListBindable(false)>]
[<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 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 BrowsableAttribute ObsoleteAttribute

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 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 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 . Ceux-ci peuvent contenir d’autres MenuItem objets, représentant des éléments de sous-menu. Les MenuItem objets peuvent être stockés dans une MainMenu structure de menu entière pour un formulaire ou un ContextMenu objet 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 un grand nombre de ses propriétés. Si vous utilisez votre menu dans une application MDI (multidocument 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 une MainMenu ou ContextMenu, cette propriété contient tous les MenuItem objets affichés. Pour un MenuItem, la MenuItems propriété représente les éléments de sous-menu qui lui sont associés.

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

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

Nom	Description
Menu(MenuItem[])	Obsolète. Initialise une nouvelle instance de la classe Menu.

Champs

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

Propriétés

Nom	Description
CanRaiseEvents	Obsolète. Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
Container	Obsolète. Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
DesignMode	Obsolète. Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
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.
IsParent	Obsolète. Obtient une valeur indiquant si ce menu contient des éléments de menu. Cette propriété est en lecture seule.
MdiListItem	Obsolète. Obtient une valeur indiquant celle MenuItem utilisée pour afficher une liste de formulaires enfants multi-interface de document (MDI).
MenuItems	Obsolète. Obtient une valeur indiquant la collection d’objets MenuItem associés au menu.
Name	Obsolète. Obtient ou définit le nom du 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.

Méthodes

Nom	Description
CloneMenu(Menu)	Obsolète. Copie l’objet Menu passé en tant que paramètre à l’état actuel Menu.
CreateMenuHandle()	Obsolète. Crée un handle pour le 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 Menu.
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.
FindMergePosition(Int32)	Obsolète. Retourne la position à laquelle un élément de menu doit être inséré dans le menu.
GetContextMenu()	Obsolète. Obtient le ContextMenu menu qui contient ce 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.
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(Menu)	Obsolète. Fusionne les MenuItem objets d’un menu avec le menu actif.
ProcessCmdKey(Message, Keys)	Obsolète. Traite une clé de commande.
ToString()	Obsolète. Retourne un String qui représente le Menu contrôle.

Événements

Nom	Description
Disposed	Obsolète. Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)

S’applique à

Voir aussi

Commentaires

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