Compartir a través de

Combinar elementos de menú en el control MenuStrip de Windows Forms

Si tiene una aplicación de interfaz de varios documentos (MDI), puede combinar elementos de menú o menús completos desde el formulario secundario en los menús del formulario primario.

En este tema se describen los conceptos básicos asociados con la combinación de elementos de menú en una aplicación MDI.

Conceptos generales

Los procedimientos de fusión involucran tanto un objetivo como un control de origen.

  • El destino es el control MenuStrip en el formulario principal o MDI en el que está fusionando elementos de menú.

  • El origen es el control MenuStrip en el formulario hijo MDI que contiene los elementos de menú que desea integrar en el menú de destino.

La MdiWindowListItem propiedad identifica el elemento de menú cuya lista desplegable rellenará con los títulos de los elementos secundarios MDI del formulario primario MDI actual. Por ejemplo, normalmente se enumeran los elementos secundarios de MDI que están abiertos actualmente en el menú Ventana .

La IsMdiWindowListEntry propiedad identifica qué elementos de menú proceden de un MenuStrip formulario secundario MDI.

Puede combinar elementos de menú de forma manual o automática. Los elementos de menú se combinan de la misma manera para ambos métodos, pero la combinación se activa de forma diferente, como se describe en las secciones "Combinación manual" y "Combinación automática" más adelante en este tema. En combinación manual y automática, cada acción de combinación afecta a la siguiente acción de combinación.

MenuStrip La combinación mueve los elementos de menú de uno ToolStrip a otro en lugar de clonarlos, como era el caso de MainMenu.

Valores de acción de combinación

Se establece la acción de combinación en los elementos de menú en el origen MenuStrip mediante la propiedad MergeAction.

En la tabla siguiente se describe el significado y el uso típico de las acciones de combinación disponibles.

Valor de acción de fusión Descripción Uso típico
Append (Valor predeterminado) Agrega el elemento de origen al final de la colección del elemento de destino. Agregar elementos de menú al final del menú cuando se activa alguna parte del programa.
Insert Agrega el elemento de origen a la colección del elemento de destino, en la ubicación especificada por la MergeIndex propiedad establecida en el elemento de origen. Agregar elementos de menú al centro o al principio del menú cuando se activa alguna parte del programa.

Si el valor de MergeIndex es el mismo para ambos elementos del menú, se agregan en orden inverso. Establezca MergeIndex adecuadamente para conservar el orden original.
Replace Busca una coincidencia de texto o usa el MergeIndex valor si no se encuentra ninguna coincidencia de texto y, a continuación, reemplaza el elemento de menú de destino coincidente por el elemento de menú de origen. Reemplazar un elemento de menú de destino por un elemento de menú de origen con el mismo nombre que hace algo diferente.
MatchOnly Busca una coincidencia de texto o usa el MergeIndex valor si no se encuentra ninguna coincidencia de texto y, a continuación, agrega todos los elementos desplegables del origen al destino. Crear una estructura de menú que inserta o agrega elementos de menú en un submenú, o quita elementos de menú de un submenú. Por ejemplo, puede agregar una opción del menú de una ventana secundaria MDI a un menú principal MenuStripGuardar como.

MatchOnly permite navegar por la estructura del menú sin realizar ninguna acción. Proporciona una manera de evaluar los elementos posteriores.
Remove Busca una coincidencia de texto o usa el MergeIndex valor si no se encuentra ninguna coincidencia de texto y, a continuación, quita el elemento del destino. Quitar un elemento de menú del destino MenuStrip.

Combinación manual

Solo MenuStrip controles participan en la combinación automática. Para combinar los elementos de otros controles, como ToolStrip y StatusStrip, debe combinarlos manualmente llamando a los métodos Merge y RevertMerge en su código según sea necesario.

Combinación automática

Puede usar la combinación automática para aplicaciones MDI activando el formulario de origen. Para usar en una aplicación MDI MenuStrip, establezca la propiedad MainMenuStrip en el destino MenuStrip para que las acciones de combinación realizadas en el origen MenuStrip se reflejen en el destino MenuStrip.

Puede desencadenar la combinación automática activando el MenuStrip en el origen MDI. Tras la activación, el origen MenuStrip se combina con el destino MDI. Cuando se activa un nuevo formulario, la combinación se revierte en el último formulario y se desencadena en el nuevo formulario. Puede controlar este comportamiento estableciendo la MergeAction propiedad según sea necesario en cada ToolStripItemy estableciendo la AllowMerge propiedad en cada MenuStrip.

Consulte también

  • Last updated on