Exportar (0) Imprimir
Expandir todo

MenuItem (Clase)

Representa un elemento individual que se muestra dentro de un control MainMenu o ContextMenu. Aunque el control ToolStripMenuItem reemplaza y agrega funcionalidad al control MenuItem de versiones anteriores, se conserva MenuItem a efectos de compatibilidad con versiones anteriores y uso futuro, en su caso.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public class MenuItem : Menu
public class MenuItem extends Menu
public class MenuItem extends Menu
No aplicable.

Para que MenuItem se muestre, se debe agregar a un control MainMenu o ContextMenu. Para crear submenús, se pueden agregar objetos MenuItem a la propiedad MenuItems del objeto MenuItem primario.

La clase MenuItem proporciona las propiedades que permiten configurar la apariencia y funcionalidad de un elemento de menú. Para mostrar una marca de verificación junto al elemento de menú, utilice la propiedad Checked. Se puede utilizar esta característica para identificar un elemento de menú que está seleccionado en una lista de elementos de menú que se excluyen mutuamente. Por ejemplo, si se dispone de un conjunto de elementos de menú para establecer el color del texto de un control TextBox, utilice la propiedad Checked para identificar qué color está seleccionado en ese momento. La propiedad Shortcut se puede utilizar para definir una combinación de teclas que se puede presionar para seleccionar el elemento de menú.

Para los objetos MenuItem que se muestran en una aplicación de Interfaz de múltiples documentos (MDI), se puede utilizar el método MergeMenu para combinar los menús de los formularios MDI primarios con los menús de los formularios secundarios y crear así una estructura de menús consolidada. Debido a que no se puede utilizar un objeto MenuItem en varios lugares al mismo tiempo, por ejemplo, en MainMenu y ContextMenu, utilice el método CloneMenu para crear una copia de un objeto MenuItem para utilizarlo en otro lugar.

El evento Popup permite realizar tareas antes de mostrar un menú. Por ejemplo, se puede crear un controlador de eventos para que este evento muestre u oculte elementos de menú en función del estado del código. El evento Select permite realizar tareas como proporcionar ayuda detallada para los elementos de menú de la aplicación cuando el usuario sitúa el puntero del mouse (ratón) sobre un elemento de menú.

En el siguiente ejemplo de código se crea la estructura de menús de un formulario. El código de ejemplo agrega un objeto MenuItem que representa 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 las opciones de fuente grande y pequeña de una aplicación. En el ejemplo se supone que existen un objeto MainMenu denominado mainMenu1 y cuatro objetos MenuItem denominados menuItem1, menuItem2, menuItem3 y 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.set_Text("Edit");

    // Set the caption for the first submenu.
    menuItem2.set_Text("Font Size");

    // Set the caption for menuItem2's first submenu.
    menuItem3.set_Text("Small");

    // Set the checked property to true since this is the default value.
    menuItem3.set_Checked(true);

    // Define a shortcut key combination for the menu item.
    menuItem3.set_Shortcut(Shortcut.CtrlS);

    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.set_Text("Large");

    // Define a shortcut key combination for the menu item.
    menuItem4.set_Shortcut(Shortcut.CtrlL);

    // Set the index of the menu item so it is placed below
    //the first submenu item.
    menuItem4.set_Index(1);

    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.get_MenuItems().Add(menuItem3);
    menuItem2.get_MenuItems().Add(menuItem4);

    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.get_MenuItems().Add(menuItem2);

    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.get_MenuItems().Add(menuItem1);
} //CreateMyMenu

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar:
© 2014 Microsoft