Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

ContextMenu (Clase)

representa un menú contextual. Aunque ContextMenuStrip reemplaza y agrega funcionalidad al control de ContextMenu de versiones anteriores, ContextMenu se conserva por compatibilidad con versiones anteriores y uso futuro si elige.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
public class ContextMenu : Menu

El tipo ContextMenu expone los siguientes miembros.

  NombreDescripción
Método públicoContextMenu()Inicializa una nueva instancia de la clase de ContextMenu sin los elementos de menú especificados.
Método públicoContextMenu(MenuItem[])Inicializa una nueva instancia de la clase de ContextMenu con un conjunto especificado de objetos de MenuItem .
Arriba
  NombreDescripción
Propiedad protegidaCanRaiseEventsObtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad públicaContainerObtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad protegidaDesignModeObtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegidaEventsObtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad públicaHandleObtiene un valor que representa el identificador de ventana del menú. (Se hereda de Menu).
Propiedad públicaIsParentObtiene un valor que indica si este menú contiene los elementos de menú. Esta propiedad es de solo lectura. (Se hereda de Menu).
Propiedad públicaMdiListItemObtiene un valor que indica MenuItem que se utiliza para mostrar una lista de (MDI) formularios secundarios de interfaz de múltiples documentos. (Se hereda de Menu).
Propiedad públicaMenuItemsObtiene un valor que indica la colección de objetos MenuItem asociado al menú. (Se hereda de Menu).
Propiedad públicaNameobtiene o establece el nombre de Menu. (Se hereda de Menu).
Propiedad públicaRightToLeftObtiene o establece un valor que indica si el texto mostrado por el control se muestra de derecha a izquierda.
Propiedad públicaSiteObtiene o establece ISite de Component. (Se hereda de Component).
Propiedad públicaSourceControlObtiene el control que muestra el menú contextual.
Propiedad públicaTagObtiene o establece los datos definidos por el usuario asociado al control. (Se hereda de Menu).
Arriba
  NombreDescripción
Método protegidoCloneMenucopia Menu que se pasa como parámetro a Menuactual. (Se hereda de Menu).
Método protegidoCreateMenuHandleCrea un nuevo identificador de Menu. (Se hereda de Menu).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por Component. (Se hereda de Component).
Método protegidoDispose(Boolean)Desecha los recursos, con excepción de memoria insuficiente, utilizado por Menu. (Se hereda de Menu).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalizeLibera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método públicoFindMenuItemobtiene MenuItem que contiene el valor especificado. (Se hereda de Menu).
Método protegidoFindMergePositionDevuelve la posición en la que un elemento de menú se debe insertar en el menú. (Se hereda de Menu).
Método públicoGetContextMenuobtiene ContextMenu que contiene este menú. (Se hereda de Menu).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoGetMainMenuobtiene MainMenu que contiene este menú. (Se hereda de Menu).
Método protegidoGetServiceDevuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método públicoGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoMergeMenucombina los objetos de MenuItem de un menú con el menú actual. (Se hereda de Menu).
Método protegidoOnCollapseInfraestructura. Provoca el evento de Collapse .
Método protegidoOnPopupInfraestructura. Provoca el evento de Popup
Método protegidoProcessCmdKey(Message, Keys)procesa una tecla de comando. (Se hereda de Menu).
Método protegidoProcessCmdKey(Message, Keys, Control)procesa una tecla de comando.
Método públicoShow(Control, Point)Muestra el menú contextual en la posición especificada.
Método públicoShow(Control, Point, LeftRightAlignment)Muestra el menú contextual en la posición especificada y con la alineación especificada.
Método públicoToStringdevuelve String que representa el control de Menu . (Se hereda de Menu).
Arriba
  NombreDescripción
Evento públicoCollapseSe produce cuando se contrae debajo del menú contextual.
Evento públicoDisposedSe produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento públicoPopupSe produce antes de que se muestre el menú contextual.
Arriba

La clase de ContextMenu representa los menús contextuales que se pueden mostrar cuando el usuario hace clic con el botón secundario del mouse sobre un control o un área de formulario. Los menús contextuales se utilizan normalmente para combinar varios elementos de menú de MainMenu de un formulario que son útiles para el usuario especificado el contexto de la aplicación. Por ejemplo, puede utilizar un menú contextual asignado a un control de TextBox para proporcionar los elementos de menú para cambiar la fuente del texto, buscar texto dentro del control, o las características del portapapeles para copiar y pegar el texto. También puede mostrar los nuevos objetos de MenuItem en un menú contextual que no se encuentran dentro de MainMenu para proporcionar la situación los comandos específicos que no son adecuados para que MainMenu muestra.

Normalmente, se muestra un menú contextual cuando el usuario hace clic con el botón secundario del mouse sobre un control o el propio formulario. Los controles visible y Form tienen una propiedad de ContextMenu que enlaza la clase de ContextMenu al control que muestra el menú contextual. más de un control puede utilizar ContextMenu. Puede utilizar la propiedad de SourceControl para determinar que controlan por última vez mostrado el menú contextual para realizar tareas específicas del control o modificar el menú contextual presentado para el control.

Es posible que desee saber cuándo el menú contextual que se muestra para establecer marcas de verificación, deshabilitar elementos, y realizar otras tareas de menú antes de menú se muestra al usuario. Puede controlar el evento de Popup para determinar cuándo se muestra el menú contextual.

NotaNota

Reutilizar los objetos de MenuItem que se muestran en MainMenu para el uso en ContextMenu, debe crear una copia del menú mediante el método de CloneMenu de la clase de MenuItem . También puede combinar elementos de menú y sus elementos de submenú en un único objeto de MenuItem utilizando el método de MergeMenu de la clase de MenuItem .

El ejemplo de código siguiente crea un controlador de eventos para el evento Popup de ContextMenu. El código del controlador de eventos determina cuál de dos controles PictureBox denominado pictureBox1 y TextBox denominado textBox1 es el control que muestra el menú contextual. Dependiendo del control a ContextMenu para mostrar el menú contextual, agregará el control los objetos adecuados de MenuItem a ContextMenu. Este ejemplo requiere que tenga una instancia de la clase de ContextMenu , denominado contextMenu1, definido dentro del formulario. Este ejemplo también requiere que tenga TextBox y PictureBox agregados a un formulario y que la propiedad de ContextMenu de estos controles está establecida en contextMenu1.


private void MyPopupEventHandler(System.Object sender, System.EventArgs e)
 {
    // Define the MenuItem objects to display for the TextBox.
    MenuItem menuItem1 = new MenuItem("&Copy");
    MenuItem menuItem2 = new MenuItem("&Find and Replace");
    // Define the MenuItem object to display for the PictureBox.
    MenuItem menuItem3 = new MenuItem("C&hange Picture");

    // Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear();

    if(contextMenu1.SourceControl == textBox1)
    {
       // Add MenuItems to display for the TextBox.
       contextMenu1.MenuItems.Add(menuItem1);
       contextMenu1.MenuItems.Add(menuItem2);
    }
    else if(contextMenu1.SourceControl == pictureBox1)
    {
       // Add the MenuItem to display for the PictureBox.
       contextMenu1.MenuItems.Add(menuItem3);
    }
 }


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos 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.
¿Te ha resultado útil?
(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR
© 2013 Microsoft. Reservados todos los derechos.