Menu Clase

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 MenuItemclase derivada,, para crear una estructura de menú 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 MenuItem un para representar el elemento de menú de nivel superior, le 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 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 haya un MainMenu objeto denominado mainMenu1 y menuItem2 menuItem4 menuItem1 MenuItemcuatroobjetos denominados, ,y.menuItem3The 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 las MainMenuclases MenuItem, y ContextMenu .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 una aplicación se componen de MenuItem objetos.The menus for an application consist of MenuItem objects. Pueden contener otros MenuItem objetos, que representan elementos de submenú.These can contain other MenuItem objects, representing submenu items. Los MenuItem objetos se pueden almacenar en un MainMenu para mostrarse como una estructura de menú completa para un formulario ContextMenu o un que se usa 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 que es 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, Menu la clase usa 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 usa el menú en una aplicación de interfaz de múltiples documentos (MDI), puede usar la MdiListItem propiedad para especificar un MenuItem que muestre una lista de formularios MDI secundarios 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. La 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 objeto ContextMenuo, esta propiedad contiene todos MenuItem los objetos que se muestran.For a MainMenu or ContextMenu, this property contains all the MenuItem objects that are displayed. En el caso de MenuItems ,lapropiedadrepresentaloselementosdesubmenúasociadosaél.MenuItemFor a MenuItem, the MenuItems property represents the submenu items associated with it.

Además de las propiedades que se proporcionan para todas las clases de menú derivadas, Menu la clase también proporciona métodos, CloneMenu como y MergeMenu, que permiten crear nuevos menús a partir de los menús existentes, y también combinar dos estructuras de menús. forma.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.

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

Constructores

Menu(MenuItem[])

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

Campos

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

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

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

(Heredado de Component)
Container

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

(Heredado de 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.

(Heredado de Component)
Events

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

(Heredado de Component)
Handle

Obtiene un valor que representa el identificador de ventana del menú.Gets a value representing the window handle for the 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 sólo lectura.This property is read-only.

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

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

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

Site

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

(Heredado de 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.

Métodos

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

Crea un nuevo identificador para Menu.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.

(Heredado de MarshalByRefObject)
Dispose()

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

(Heredado de Component)
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)

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

(Heredado de Object)
FindMenuItem(Int32, IntPtr)

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

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

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

GetHashCode()

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

(Heredado de 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.

(Heredado de MarshalByRefObject)
GetMainMenu()

Obtiene el objeto MainMenu que contiene este menú.Gets the MainMenu that contains this 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.

(Heredado de Component)
GetType()

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

(Heredado de 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.

(Heredado de MarshalByRefObject)
MemberwiseClone()

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de 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.

ProcessCmdKey(Message, Keys)

Procesa una tecla de comando.Processes a command key.

ToString()

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

Eventos

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.

(Heredado de Component)

Se aplica a

Consulte también: