Menu Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa la funcionalidad base de todos los menús.

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. En su lugar se usa ToolStripDropDown y ToolStripDropDownMenu, que reemplazan y extienden el control Menu.

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Herencia: Object

MarshalByRefObject

Component
Menu

Derivado: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Atributos: ListBindableAttribute

Ejemplos

En el ejemplo de código siguiente se usa la clase derivada , MenuItempara crear una estructura de menú para un formulario. El código de ejemplo agrega un MenuItem elemento para representar el elemento de menú de nivel superior, agrega un elemento de submenú a él para seleccionar un tamaño de fuente y, a continuación, agrega dos submenúes a ese elemento de menú que representan opciones de fuente grandes y pequeñas en una aplicación. En el ejemplo se requiere que haya un MainMenu objeto denominado mainMenu1 y cuatro MenuItem objetos denominados menuItem1, menuItem2, menuItem3y 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 no está disponible en .NET Core 3.1 y versiones posteriores. Utilice ToolStripDropDown y ToolStripDropDownMenu en su lugar.

Esta clase es la clase base para las MainMenuclases , MenuItemy ContextMenu . No se puede crear una instancia de esta clase. Los menús de una aplicación constan de MenuItem objetos. Estos pueden contener otros MenuItem objetos, que representan elementos de submenú. Los MenuItem objetos se pueden almacenar en para MainMenu mostrarse como una estructura de menú completa para un formulario o que ContextMenu se usa para mostrar menús contextuales. Esta clase proporciona funcionalidad común para todas las clases de menú.

A diferencia de muchas clases base, la Menu clase usa sus clases derivadas para definir muchas de sus propiedades. Si usa el menú en una aplicación de interfaz de varios documentos (MDI), puede usar la MdiListItem propiedad para especificar un MenuItem que muestre una lista de formularios secundarios MDI abiertos en la aplicación. La MenuItems propiedad contiene una lista de MenuItem objetos almacenados en la clase de menú. Para o MainMenu ContextMenu, esta propiedad contiene todos los MenuItem objetos que se muestran. Para , MenuItemla MenuItems propiedad representa los elementos de submenú asociados a él.

Además de las propiedades proporcionadas para todas las clases de menú derivadas, la Menu clase también proporciona métodos, como CloneMenu y MergeMenu, que le permiten crear nuevos menús a partir de menús existentes y también combinar dos estructuras de menú.

La Menu clase también define la clase Menu.MenuItemCollectionanidada . Esta clase define la colección de MenuItem objetos usados por la MenuItems propiedad . Puede usar los métodos de la Menu.MenuItemCollection clase para agregar y quitar elementos de menú de , ContextMenu MainMenuo MenuItem.

Constructores

Menu(MenuItem[])

Inicializa una nueva instancia de la clase Menu.

Campos

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

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ú.
IsParent	Obtiene un valor que indica si este menú contiene elementos de menú. Esta propiedad es de sólo lectura.
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).
MenuItems	Obtiene un valor que indica la colección de objetos MenuItem asociados al menú.
Name	Obtiene o establece el nombre de Menu.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Tag	Obtiene o establece los datos definidos por el usuario asociados con el control.

Métodos

CloneMenu(Menu)	Copia el objeto Menu que se pasa como un parámetro al objeto Menu actual.
CreateMenuHandle()	Crea un nuevo identificador para 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. (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 Menu.
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.
FindMergePosition(Int32)	Devuelve la posición en la que se debe insertar un elemento de menú.
GetContextMenu()	Obtiene el objeto ContextMenu que contiene este menú.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoleto. 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ú.
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()	Obsoleto. 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.
ProcessCmdKey(Message, Keys)	Procesa una tecla de comando.
ToString()	Devuelve una cadena String que representa el control Menu.

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().

(Heredado de Component)

Se aplica a