MainMenu Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Representa la estructura de menú de un formulario.

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. En su lugar se usa MenuStrip, que reemplaza y extiende el control MainMenu.

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

Herencia

Object

MarshalByRefObject

Component

Menu

MainMenu

Ejemplos

En el ejemplo de código siguiente se crea un MainMenuobjeto , se asignan dos MenuItem objetos a MainMenu y se enlazan a un formulario. En este ejemplo se requiere que tenga un Form creado denominado 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

Comentarios

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. Utilice MenuStrip en su lugar.

El MainMenu control representa el contenedor de la estructura de menús de un formulario. Un menú se compone de MenuItem objetos que representan los comandos de menú individuales en la estructura de menús. Cada MenuItem uno puede ser un comando para la aplicación o un menú primario para otros elementos de submenú. Para enlazar al MainMenuForm objeto que lo mostrará, asigne MainMenu a la Menu propiedad de Form.

En el caso de las aplicaciones que tendrán compatibilidad con varios idiomas, puede usar la RightToLeft propiedad para mostrar el texto del menú de derecha a izquierda para admitir idiomas como el árabe.

Puede crear diferentes MainMenu objetos para representar estructuras de menú diferentes para el formulario. Si desea reutilizar la estructura de menús contenida en un elemento específico MainMenu, puede usar su CloneMenu método para crear una copia. Una vez que tenga una copia de la estructura de menús, puede realizar las modificaciones adecuadas para la nueva estructura de menús.

Nota:

Es posible que los elementos de menú de corte y pegado de un formulario a otro del diseñador no funcionen según lo previsto si el formulario en el que se pega no tiene definidos elementos de menú.

Constructores

MainMenu()	Inicializa una nueva instancia de la clase MainMenu sin ningún elemento de menú especificado.
MainMenu(IContainer)	Inicializa una nueva instancia de la clase MainMenu con el contenedor especificado.
MainMenu(MenuItem[])	Inicializa una nueva instancia de MainMenu con un conjunto especificado de objetos MenuItem.

Campos

FindHandle	Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un identificador. (Heredado de Menu)
FindShortcut	Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un acceso directo. (Heredado de Menu)

Propiedades

CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
Handle	Obtiene un valor que representa el identificador de ventana del menú. (Heredado de Menu)
IsParent	Obtiene un valor que indica si este menú contiene elementos de menú. Esta propiedad es de sólo lectura. (Heredado de Menu)
MdiListItem	Obtiene un valor que indica la clase MenuItem que se utiliza para mostrar una lista de formularios secundarios de interfaz de múltiples documentos (MDI). (Heredado de Menu)
MenuItems	Obtiene un valor que indica la colección de objetos MenuItem asociados al menú. (Heredado de Menu)
Name	Obtiene o establece el nombre de Menu. (Heredado de Menu)
RightToLeft	Obtiene o establece si el texto que muestra el control aparece de derecha a izquierda.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Tag	Obtiene o establece los datos definidos por el usuario asociados con el control. (Heredado de Menu)

Métodos

CloneMenu()	Crea un nuevo objeto MainMenu que es un duplicado del objeto MainMenu actual.
CloneMenu(Menu)	Copia el objeto Menu que se pasa como un parámetro al objeto Menu actual. (Heredado de Menu)
CreateMenuHandle()	Crea un nuevo controlador en el menú.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Se deshace de los recursos (distintos de la memoria) que usa MainMenu.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FindMenuItem(Int32, IntPtr)	Obtiene el objeto MenuItem que contiene el valor especificado. (Heredado de Menu)
FindMergePosition(Int32)	Devuelve la posición en la que se debe insertar un elemento de menú. (Heredado de Menu)
GetContextMenu()	Obtiene el objeto ContextMenu que contiene este menú. (Heredado de Menu)
GetForm()	Obtiene el objeto Form que contiene este nodo.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetMainMenu()	Obtiene el objeto MainMenu que contiene este menú. (Heredado de Menu)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
MergeMenu(Menu)	Combina los objetos MenuItem de un menú en el menú actual. (Heredado de Menu)
OnCollapse(EventArgs)	Genera el evento Collapse.
ProcessCmdKey(Message, Keys)	Procesa una tecla de comando. (Heredado de Menu)
ToString()	Devuelve una cadena que representa MainMenu.

Eventos

Collapse	Se produce cuando el menú principal se contrae.
Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Consulte también

• MenuItem
• Add(String)
• Menu
• MenuItems
• MenuStrip
• ContextMenuStrip
• MenuStrip (Control de formularios Windows Forms)