MainMenu MainMenu MainMenu MainMenu Class

Definición

Representa la estructura de menú de un formulario.Represents the menu structure of a form. Aunque el control MenuStrip reemplaza y agrega funcionalidad al control MainMenu de las versiones anteriores, MainMenu se conserva a efectos de compatibilidad con versiones anteriores y uso futuro, si se desea.Although MenuStrip replaces and adds functionality to the MainMenu control of previous versions, MainMenu is retained for both backward compatibility and future use if you choose.

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

Ejemplos

En el ejemplo de código siguiente MainMenuse crea un, se MenuItem asignan dos MainMenu objetos a y se enlaza a un formulario.The following code example creates a MainMenu, assigns two MenuItem objects to the MainMenu and binds it to a form. Este ejemplo requiere que se haya creado Form un denominado. Form1This example requires that you have a Form created that is named 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

El MainMenu control representa el contenedor para la estructura de menú de un formulario.The MainMenu control represents the container for the menu structure of a form. Un menú se compone de MenuItem objetos que representan los comandos de menú individuales en la estructura del menú.A menu is composed of MenuItem objects that represent the individual menu commands in the menu structure. Cada MenuItem puede ser un comando para la aplicación o un menú primario para otros elementos de submenú.Each MenuItem can be a command for your application or a parent menu for other submenu items. Para enlazar MainMenu el Form a que lo MainMenu mostrará, asigne a la Menu propiedad de Form.To bind the MainMenu to the Form that will display it, assign the MainMenu to the Menu property of the Form.

En el caso de las aplicaciones que tengan compatibilidad con varios idiomas, puede RightToLeft usar la propiedad para mostrar el texto del menú de derecha a izquierda para idiomas de soporte como el árabe.For applications that will have support for multiple languages, you can use the RightToLeft property to display the text of the menu from right to left to support languages such as Arabic.

Puede crear objetos diferentes MainMenu para representar distintas estructuras de menú para el formulario.You can create different MainMenu objects to represent different menu structures for your form. Si desea volver a usar la estructura de menú contenida en MainMenuun específico, puede utilizar CloneMenu su método para crear una copia.If you want to reuse the menu structure contained in a specific MainMenu, you can use its CloneMenu method to create a copy. Una vez que tenga una copia de la estructura de menús, puede realizar las modificaciones adecuadas para la nueva estructura de menús.Once you have a copy of the menu structure, you can make the appropriate modifications for your new menu structure.

Nota

Cortar y pegar elementos de menú de un formulario a otro en el diseñador podría no funcionar según lo esperado si el formulario en el que se va a pegar no tiene elementos de menú definidos.Cutting and pasting menu items from one form to another in the designer might not work as expected if the form you are pasting into has no menu items defined.

Constructores

MainMenu() MainMenu() MainMenu() MainMenu()

Inicializa una nueva instancia de la clase MainMenu sin ningún elemento de menú especificado.Initializes a new instance of the MainMenu class without any specified menu items.

MainMenu(IContainer) MainMenu(IContainer) MainMenu(IContainer) MainMenu(IContainer)

Inicializa una nueva instancia de la clase MainMenu con el contenedor especificado.Initializes a new instance of the MainMenu class with the specified container.

MainMenu(MenuItem[]) MainMenu(MenuItem[]) MainMenu(MenuItem[]) MainMenu(MenuItem[])

Inicializa una nueva instancia de MainMenu con un conjunto especificado de objetos MenuItem.Initializes a new instance of the MainMenu with a specified set of MenuItem objects.

Propiedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Handle Handle Handle Handle

Obtiene un valor que representa el identificador de ventana del menú.Gets a value representing the window handle for the menu.

(Inherited from Menu)
IsParent IsParent IsParent IsParent

Obtiene un valor que indica si este menú contiene elementos de menú.Gets a value indicating whether this menu contains any menu items. Esta propiedad es de sólo lectura.This property is read-only.

(Inherited from Menu)
MdiListItem MdiListItem MdiListItem 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).Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Inherited from Menu)
MenuItems MenuItems MenuItems MenuItems

Obtiene un valor que indica la colección de objetos MenuItem asociados al menú.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Inherited from Menu)
Name Name Name Name

Obtiene o establece el nombre de Menu.Gets or sets the name of the Menu.

(Inherited from Menu)
RightToLeft RightToLeft RightToLeft RightToLeft

Obtiene o establece si el texto que muestra el control aparece de derecha a izquierda.Gets or sets whether the text displayed by the control is displayed from right to left.

Site Site Site Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Tag Tag Tag Tag

Obtiene o establece los datos definidos por el usuario asociados con el control.Gets or sets user-defined data associated with the control.

(Inherited from Menu)

Métodos

CloneMenu() CloneMenu() CloneMenu() CloneMenu()

Crea un nuevo objeto MainMenu que es un duplicado del objeto MainMenu actual.Creates a new MainMenu that is a duplicate of the current MainMenu.

CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu)

Copia el objeto Menu que se pasa como un parámetro al objeto Menu actual.Copies the Menu that is passed as a parameter to the current Menu.

(Inherited from Menu)
CreateMenuHandle() CreateMenuHandle() CreateMenuHandle() CreateMenuHandle()

Crea un nuevo controlador en el menú.Creates a new handle to the Menu.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Se deshace de los recursos (distintos de la memoria) que usa MainMenu.Disposes of the resources, other than memory, used by the MainMenu.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr)

Obtiene el objeto MenuItem que contiene el valor especificado.Gets the MenuItem that contains the value specified.

(Inherited from Menu)
FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32)

Devuelve la posición en la que se debe insertar un elemento de menú.Returns the position at which a menu item should be inserted into the menu.

(Inherited from Menu)
GetContextMenu() GetContextMenu() GetContextMenu() GetContextMenu()

Obtiene el objeto ContextMenu que contiene este menú.Gets the ContextMenu that contains this menu.

(Inherited from Menu)
GetForm() GetForm() GetForm() GetForm()

Obtiene el objeto Form que contiene este nodo.Gets the Form that contains this control.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMainMenu() GetMainMenu() GetMainMenu() GetMainMenu()

Obtiene el objeto MainMenu que contiene este menú.Gets the MainMenu that contains this menu.

(Inherited from Menu)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu)

Combina los objetos MenuItem de un menú en el menú actual.Merges the MenuItem objects of one menu with the current menu.

(Inherited from Menu)
OnCollapse(EventArgs) OnCollapse(EventArgs) OnCollapse(EventArgs) OnCollapse(EventArgs)

Genera el evento Collapse.Raises the Collapse event.

ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys)

Procesa una tecla de comando.Processes a command key.

(Inherited from Menu)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa MainMenu.Returns a string that represents the MainMenu.

Eventos

Collapse Collapse Collapse Collapse

Se produce cuando el menú principal se contrae.Occurs when the main menu collapses.

Disposed Disposed Disposed Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Campos

FindHandle FindHandle FindHandle FindHandle

Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un identificador.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Inherited from Menu)
FindShortcut FindShortcut FindShortcut FindShortcut

Especifica que el método FindMenuItem(Int32, IntPtr) debe buscar un acceso directo.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Inherited from Menu)

Se aplica a

Consulte también: