MainMenu Class

Definition

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
Inheritance

Examples

En el ejemplo de código siguiente se crea un MainMenu, se asignan dos objetos MenuItem a la MainMenu 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. En este ejemplo se requiere que se haya creado una Form denominada Form1.This 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

Remarks

El control MainMenu 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 el MainMenu al Form que lo mostrará, asigne el MainMenu a la propiedad Menu del 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 usar la propiedad RightToLeft para mostrar el texto del menú de derecha a izquierda para idiomas de compatibilidad 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 diferentes objetos de 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 reutilizar la estructura de menú contenida en una MainMenuespecífica, puede utilizar su método CloneMenu 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.

Note

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.

Constructors

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)

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[])

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.

Fields

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

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)

Properties

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

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Inherited from Component)
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

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

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

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 solo lectura.This property is read-only.

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

(Inherited from Menu)
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

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

(Inherited from Menu)
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

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

(Inherited from Component)
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)

Methods

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)

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()

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

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()

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

(Inherited from Component)
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)

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)

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

(Inherited from Menu)
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()

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

(Inherited from Menu)
GetForm()

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

GetHashCode()

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

(Inherited from Object)
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()

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

(Inherited from Menu)
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()

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

(Inherited from Object)
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()

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

(Inherited from Object)
MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
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)

Inicia el evento Collapse.Raises the Collapse event.

ProcessCmdKey(Message, Keys)

Procesa una tecla de comando.Processes a command key.

(Inherited from Menu)
ToString()

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

Events

Collapse

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

Disposed

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

(Inherited from Component)

Applies to

See also