Exportación de una cinta de opciones del Diseñador de cintas a XML de la cinta

  • Artículo

El elemento Ribbon (Diseñador visual) no admite todos los tipos posibles de personalización de la cinta de opciones. Para personalizar la cinta de opciones de maneras avanzadas, puede exportar la cinta de opciones desde el diseñador a XML de la cinta de opciones y editar el XML directamente.

Nota:

No todos los valores de propiedad aparecen en el archivo XML de la cinta de opciones. Para obtener más información, consulte Introducción a la cinta de opciones.

Se aplica a: La información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para las siguientes aplicaciones: Excel; InfoPath 2013 e InfoPath 2010; Outlook; Powerpoint; Proyecto; Visio; Palabra. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Para exportar una cinta de opciones del Diseñador de cintas a XML de la cinta

  1. Haga clic con el botón derecho en el archivo de código de la cinta de opciones en Explorador de soluciones y, a continuación, haga clic en Diseñador de vistas.

  2. Haga clic con el botón derecho en el Diseñador de cinta de opciones y, a continuación, haga clic en Exportar cinta de opciones a XML.

    Visual Studio agrega un archivo XML de cinta de opciones y un archivo de código XML de la cinta de opciones al proyecto.

  3. En la clase de código de la cinta de opciones, busque los comentarios que comienzan por TODO:.

  4. Copie el bloque de código de estos comentarios en la clase ThisAddin, ThisWorkbook o ThisDocument , en función del tipo de solución que esté desarrollando.

    Este código permite que Microsoft aplicación de Office lication detecte y cargue la cinta de opciones personalizada. Para obtener más información, consulta Ribbon XML.

  5. En la clase ThisAddin, ThisWorkbook o ThisDocument , quite la marca de comentario del bloque de código.

    Después de quitar la marca de comentario del código, debe ser similar al ejemplo siguiente. En este ejemplo, la clase Ribbon se denomina MyRibbon.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

  6. Cambie al archivo de código XML de la cinta de opciones y busque la Ribbon Callbacks región.

    Aquí es donde se escriben métodos de devolución de llamada para controlar las acciones del usuario, como hacer clic en un botón.

  7. Cree un método de devolución de llamada para cada controlador de eventos que escribió en el código del Diseñador de cintas de opciones.

  8. Mueva todo el código del controlador de eventos de los controladores de eventos a los métodos de devolución de llamada y modifique el código para que funcione con el modelo de programación de extensibilidad de la cinta (RibbonX).

    Para obtener información sobre cómo escribir métodos de devolución de llamada y usar el modelo de programación RibbonX, vea Ribbon XML.

Contenido relacionado