MainMenu 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 la structure de menus d'un formulaire.

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez MenuStrip plutôt, ce qui remplace et étend le MainMenu contrôle.

public ref class MainMenu : System::Windows::Forms::Menu

public class MainMenu : System.Windows.Forms.Menu

type MainMenu = class
    inherit Menu

Public Class MainMenu
Inherits Menu

Héritage: Object

MarshalByRefObject

Component

Menu
MainMenu

Exemples

L’exemple de code suivant crée un MainMenu, affecte deux MenuItem objets au et le MainMenu lie à un formulaire. Cet exemple nécessite que vous ayez créé un Form qui est nommé Form1.

void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu^ mainMenu1 = gcnew MainMenu;
   MenuItem^ menuItem1 = gcnew MenuItem;
   MenuItem^ menuItem2 = gcnew MenuItem;
   menuItem1->Text = "File";
   menuItem2->Text = "Edit";

   // Add two MenuItem objects to the MainMenu.
   mainMenu1->MenuItems->Add( menuItem1 );
   mainMenu1->MenuItems->Add( menuItem2 );

   // Bind the MainMenu to Form1.
   Menu = mainMenu1;
}

public void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu mainMenu1 = new MainMenu();

   MenuItem menuItem1 = new MenuItem();
   MenuItem menuItem2 = new MenuItem();

   menuItem1.Text = "File";
   menuItem2.Text = "Edit";
   // Add two MenuItem objects to the MainMenu.
   mainMenu1.MenuItems.Add(menuItem1);
   mainMenu1.MenuItems.Add(menuItem2);
   
   // Bind the MainMenu to Form1.
   Menu = mainMenu1;   
}

Public Sub CreateMyMainMenu()
    ' Create an empty MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()
       
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    ' Add two MenuItem objects to the MainMenu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
       
    ' Bind the MainMenu to Form1.
    Menu = mainMenu1
End Sub

Remarques

Cette classe n’est pas disponible dans .NET Core 3.1 et versions ultérieures. Utilisez plutôt MenuStrip.

Le MainMenu contrôle représente le conteneur pour la structure de menu d’un formulaire. Un menu est composé d’objets MenuItem qui représentent les commandes de menu individuelles dans la structure de menu. Chacun MenuItem peut être une commande pour votre application ou un menu parent pour d’autres éléments de sous-menu. Pour lier au MainMenu qui Form l’affiche, affectez à la MainMenu Menu propriété de Form.

Pour les applications qui prendront en charge plusieurs langues, vous pouvez utiliser la RightToLeft propriété pour afficher le texte du menu de droite à gauche afin de prendre en charge des langues telles que l’arabe.

Vous pouvez créer différents MainMenu objets pour représenter différentes structures de menu pour votre formulaire. Si vous souhaitez réutiliser la structure de menu contenue dans un spécifique MainMenu, vous pouvez utiliser sa CloneMenu méthode pour créer une copie. Une fois que vous avez une copie de la structure de menu, vous pouvez apporter les modifications appropriées à votre nouvelle structure de menu.

Notes

La coupe et le collage d’éléments de menu d’un formulaire à un autre dans le concepteur peuvent ne pas fonctionner comme prévu si le formulaire dans lequel vous collez n’a aucun élément de menu défini.

Constructeurs

MainMenu()	Initialise une nouvelle instance de la classe MainMenu sans éléments de menu spécifiés.
MainMenu(IContainer)	Initialise une nouvelle instance de la classe MainMenu avec le conteneur spécifié.
MainMenu(MenuItem[])	Initialise une nouvelle instance de la classe MainMenu avec un ensemble spécifié d'objets MenuItem.

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

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. (Hérité de Menu)
IsParent	Obtient une valeur indiquant si ce menu contient des éléments de menu. Cette propriété est en lecture seule. (Hérité de Menu)
MdiListItem	Obtient une valeur indiquant le MenuItem utilisé pour afficher une liste de formulaires enfants MDI. (Hérité de Menu)
MenuItems	Obtient une valeur qui indique la collection d'objets MenuItem associée au menu. (Hérité de Menu)
Name	Obtient ou définit le nom de l'objet Menu. (Hérité de Menu)
RightToLeft	Obtient ou définit une valeur indiquant si le texte du contrôle est affiché de droite à gauche.
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)

Méthodes

CloneMenu()	Crée un nouveau MainMenu qui est un doublon du MainMenu en cours.
CloneMenu(Menu)	Copie le Menu qui est passé comme paramètre au Menu en cours. (Hérité de Menu)
CreateMenuHandle()	Crée un nouveau handle pour le 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 MainMenu.
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)
GetForm()	Obtient le Form qui contient ce contrôle.
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(Menu)	Fusionne les objets MenuItem d'un menu avec le menu en cours. (Hérité de Menu)
OnCollapse(EventArgs)	Déclenche l’événement Collapse.
ProcessCmdKey(Message, Keys)	Traite une touche de commande. (Hérité de Menu)
ToString()	Retourne une chaîne qui représente MainMenu.

Événements

Collapse	Se produit lors de la réduction du menu principal.
Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)

S’applique à