Compartir vía

Menu Clase

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll
Source:
Menu.cs
Source:
Menu.cs

Precaución

Menu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStripDropDown and ToolStripDropDownMenu instead.

Representa la funcionalidad base de todos los menús.

Esta clase no está disponible en .NET Core 3.1 y versiones posteriores. Use ToolStripDropDown y ToolStripDropDownMenu , en su lugar, que reemplace y extienda el Menu control.

public ref class Menu abstract : System::ComponentModel::Component
[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component
[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public abstract class Menu : System.ComponentModel.Component
[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component
[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type Menu = class
    inherit Component
Public MustInherit Class Menu
Inherits Component
Herencia
Object
MarshalByRefObject
Component
Menu
Derivado
Atributos
ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Ejemplos

En el ejemplo de código siguiente se usa la clase derivada , MenuItem, para crear una estructura de menú para un formulario. El código de ejemplo agrega un MenuItem objeto 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. El ejemplo 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. 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 de un formulario o que ContextMenu se usa para mostrar menús contextuales. Esta clase proporciona funcionalidad que es 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 objetos almacenados en la clase de MenuItem menú. Para o MainMenuContextMenu, 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 permiten crear nuevos menús a partir de menús existentes y también combinar dos estructuras de menús.

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 , ContextMenuMainMenuo MenuItem.

Constructores

Nombre Description
Menu(MenuItem[])
Obsoletos.

Inicializa una nueva instancia de la clase Menu.

Campos

Nombre Description
FindHandle
Obsoletos.

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

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

Propiedades

Nombre Description
CanRaiseEvents
Obsoletos.

Obtiene un valor que indica si el componente puede generar un evento.

(Heredado de Component)
Container
Obsoletos.

Obtiene el IContainer objeto que contiene el Componentobjeto .

(Heredado de Component)
DesignMode
Obsoletos.

Obtiene un valor que indica si Component el objeto está actualmente en modo de diseño.

(Heredado de Component)
Events
Obsoletos.

Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto .

(Heredado de Component)
Handle
Obsoletos.

Obtiene un valor que representa el identificador de ventana del menú.
IsParent
Obsoletos.

Obtiene un valor que indica si este menú contiene elementos de menú. Esta propiedad es de solo lectura.
MdiListItem
Obsoletos.

Obtiene un valor que indica que MenuItem se usa para mostrar una lista de varios formularios secundarios de interfaz de documento (MDI).
MenuItems
Obsoletos.

Obtiene un valor que indica la colección de MenuItem objetos asociados al menú.
Name
Obsoletos.

Obtiene o establece el nombre de .Menu
Site
Obsoletos.

Obtiene o establece el ISite del Component.

(Heredado de Component)
Tag
Obsoletos.

Obtiene o establece los datos definidos por el usuario asociados al control .

Métodos

Nombre Description
CloneMenu(Menu)
Obsoletos.

Copia el Menu objeto que se pasa como un parámetro al objeto actual Menu.
CreateMenuHandle()
Obsoletos.

Crea un nuevo identificador para .Menu
CreateObjRef(Type)
Obsoletos.

Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()
Obsoletos.

Libera todos los recursos usados por .Component

(Heredado de Component)
Dispose(Boolean)
Obsoletos.

Elimina los recursos, distintos de la memoria, usados por .Menu
Equals(Object)
Obsoletos.

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
FindMenuItem(Int32, IntPtr)
Obsoletos.

Obtiene el MenuItem objeto que contiene el valor especificado.
FindMergePosition(Int32)
Obsoletos.

Devuelve la posición en la que se debe insertar un elemento de menú en el menú.
GetContextMenu()
Obsoletos.

Obtiene el ContextMenu objeto que contiene este menú.
GetHashCode()
Obsoletos.

Actúa como función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetMainMenu()
Obsoletos.

Obtiene el MainMenu objeto que contiene este menú.
GetService(Type)
Obsoletos.

Devuelve un objeto que representa un servicio proporcionado por Component o por su Container.

(Heredado de Component)
GetType()
Obsoletos.

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()
Obsoletos.

Crea una copia superficial del Objectactual.

(Heredado de Object)
MemberwiseClone(Boolean)
Obsoletos.

Crea una copia superficial del objeto actual MarshalByRefObject .

(Heredado de MarshalByRefObject)
MergeMenu(Menu)
Obsoletos.

Combina los MenuItem objetos de un menú con el menú actual.
ProcessCmdKey(Message, Keys)
Obsoletos.

Procesa una clave de comando.
ToString()
Obsoletos.

Devuelve un String objeto que representa el Menu control .

Eventos

Nombre Description
Disposed
Obsoletos.

Se produce cuando el componente se elimina mediante una llamada al Dispose() método .

(Heredado de Component)

Se aplica a

Consulte también