Menu Menu Menu Menu Class

Definición

Representa la funcionalidad base de todos los menús.Represents the base functionality for all menus. Aunque los controles ToolStripDropDown y ToolStripDropDownMenu reemplazan y agregan funcionalidad al control Menu de versiones anteriores, se conserva Menu a efectos de compatibilidad con versiones anteriores y uso futuro, en su caso.Although ToolStripDropDown and ToolStripDropDownMenu replace and add functionality to the Menu control of previous versions, Menu is retained for both backward compatibility and future use if you choose.

public ref class Menu abstract : System::ComponentModel::Component
[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component
type Menu = class
    inherit Component
Public MustInherit Class Menu
Inherits Component
Herencia
Derivado
Atributos

Ejemplos

En el ejemplo de código siguiente se usa la clase derivada, MenuItem, para crear una estructura de menús para un formulario.The following code example uses the derived class, MenuItem, to create a menu structure for a form. El código de ejemplo agrega un MenuItem para representar el elemento de menú de nivel superior, agrega un elemento de submenú para seleccionar un tamaño de fuente y, a continuación, agrega dos elementos de submenú a ese elemento de menú que representan las opciones de fuente grandes y pequeñas en una aplicación.The example code adds a MenuItem to represent the top-level menu item, adds a submenu item to it for selecting a font size, and then adds two submenu items to that menu item that represent large and small font choices in an application. El ejemplo requiere que exista un MainMenu objeto denominado mainMenu1 y cuatro MenuItem objetos denominados menuItem1, menuItem2, menuItem3, y menuItem4.The example requires that there is a MainMenu object named mainMenu1 and four MenuItem objects named menuItem1, menuItem2, menuItem3, and 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

Comentarios

Esta clase es la clase base para el MainMenu, MenuItem, y ContextMenu clases.This class is the base class for the MainMenu, MenuItem, and ContextMenu classes. No se puede crear una instancia de esta clase.You cannot create an instance of this class. Los menús de consiste en una aplicación MenuItem objetos.The menus for an application consist of MenuItem objects. Estos pueden contener otros MenuItem objetos, que representan elementos de submenú.These can contain other MenuItem objects, representing submenu items. El MenuItem objetos se pueden almacenar en un MainMenu para mostrar como una estructura de menús completa para un formulario o un ContextMenu que se utiliza para mostrar los menús contextuales.The MenuItem objects can be stored in a MainMenu for display as an entire menu structure for a form or a ContextMenu that is used to display shortcut menus. Esta clase proporciona funcionalidad común para todas las clases de menú.This class provides functionality that is common for all the menu classes.

A diferencia de muchas clases base, el Menu clase utiliza sus clases derivadas para definir muchas de sus propiedades.Unlike many base classes, the Menu class uses its derived classes to define many of its properties. Si se utiliza el menú en una aplicación de interfaz de múltiples documentos (MDI), puede usar el MdiListItem propiedad para especificar un MenuItem que muestra una lista de formularios secundarios MDI abiertos en la aplicación.If you are using your menu in a multiple-document interface (MDI) application, you can use the MdiListItem property to specify a MenuItem that displays a list of open MDI child forms in your application. El MenuItems propiedad contiene una lista de MenuItem objetos almacenados en la clase de menú.The MenuItems property contains a list of MenuItem objects stored in the menu class. Para un MainMenu o ContextMenu, esta propiedad contiene todos los MenuItem objetos que se muestran.For a MainMenu or ContextMenu, this property contains all the MenuItem objects that are displayed. Para un MenuItem, el MenuItems propiedad representa los elementos de submenú asociados con él.For a MenuItem, the MenuItems property represents the submenu items associated with it.

Además de las propiedades que se proporcionan para todas las clases derivadas de menú, el Menu clase también proporciona métodos, como CloneMenu y MergeMenu, que le permiten crear nuevos menús desde los menús existentes y también combinar dos estructuras de menús juntos.In addition to the properties that are provided for all the derived menu classes, the Menu class also provides methods, such as CloneMenu and MergeMenu, that enable you to create new menus from existing menus, and also merge two menu structures together.

El Menu clase también define la clase anidada Menu.MenuItemCollection.The Menu class also defines the nested class Menu.MenuItemCollection. Esta clase define la colección de MenuItem objetos usados por la MenuItems propiedad.This class defines the collection of MenuItem objects used by the MenuItems property. Puede usar los métodos de la Menu.MenuItemCollection clase para agregar y quitar elementos de menú de un MainMenu, ContextMenu, o MenuItem.You can use the methods of the Menu.MenuItemCollection class to add and remove menu items from a MainMenu, ContextMenu, or MenuItem.

Constructores

Menu(MenuItem[]) Menu(MenuItem[]) Menu(MenuItem[]) Menu(MenuItem[])

Inicializa una nueva instancia de la clase Menu.Initializes a new instance of the Menu class.

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.

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.

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.

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.

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.

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.

Name Name Name Name

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

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.

Métodos

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.

CreateMenuHandle() CreateMenuHandle() CreateMenuHandle() CreateMenuHandle()

Crea un nuevo identificador para Menu.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 Menu.Disposes of the resources, other than memory, used by the Menu.

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.

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.

GetContextMenu() GetContextMenu() GetContextMenu() GetContextMenu()

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

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.

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.

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

Procesa una tecla de comando.Processes a command key.

ToString() ToString() ToString() ToString()

Devuelve una cadena String que representa el control Menu.Returns a String that represents the Menu control.

Eventos

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)

Se aplica a

Consulte también: