Tutorial: Crear una ficha personalizada usando el diseñador de la cinta de opciones

Artículo
04/28/2010

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Proyectos de nivel de aplicación Versión de Microsoft Office Excel 2007 Word 2007 Outlook 2007 PowerPoint 2007 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

Proyectos de nivel de documento
Proyectos de nivel de aplicación

Versión de Microsoft Office

Excel 2007
Word 2007
Outlook 2007
PowerPoint 2007

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

En este tutorial se muestra cómo crear una ficha personalizada de la cinta de opciones con el diseñador de la cinta de opciones. Puede utilizar el diseñador de la cinta de opciones para agregar y colocar controles en la ficha personalizada.

En este tutorial se muestran las siguientes tareas:

Crear paneles de acciones.
Crear una ficha personalizada.
Ocultar y mostrar paneles de acciones con botones de la ficha personalizada.

Nota:
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que tenga y la configuración que esté utilizando determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Visual Studio Tools para Office (componente opcional de Visual Studio 2008 Professional y Visual Studio Team System).
Microsoft Office Excel 2007.

Visual Studio Tools para Office se instala de forma predeterminada con las versiones mostradas de Visual Studio. Para comprobar si está instalado, consulte Instalar Visual Studio Tools para Office.

Para obtener una demostración en vídeo, vea Video How to: Creating a Custom Tab by Using the Ribbon Designer.

Crear un proyecto de libro de Excel

Los pasos para utilizar el diseñador de la cinta de opciones son casi idénticos para todas las aplicaciones de Office. En este ejemplo se utiliza un libro de Excel.

Para crear un proyecto de libro de Excel

Cree un proyecto de libro de Excel 2007 con el nombre MyExcelRibbon. Para obtener más información, vea Cómo: Crear proyectos de Visual Studio para Office.

Visual Studio abre el nuevo libro en el diseñador y agrega el proyecto MyExcelRibbon al Explorador de soluciones.

Crear paneles de acciones

Agregue dos paneles de acciones personalizados al proyecto. Posteriormente agregará botones a la ficha personalizada que muestren y oculten estos paneles de acciones.

Para crear paneles de acciones

En el menú Proyecto, haga clic en Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione ActionsPaneControl y, a continuación, haga clic en Agregar.

En el diseñador se abre el archivo ActionsPaneControl1.cs o ActionsPaneControl1.vb.
Desde la ficha Controles comunes del Cuadro de herramientas, agregue una etiqueta a la superficie del diseñador.
En la ventana Propiedades, establezca la propiedad Texto de label1 en Actions Pane 1.
Repita los pasos del 1 al 5 para crear un segundo panel de acciones y una etiqueta. Establezca la propiedad Texto de la segunda etiqueta en Actions Pane 2.

Crear una ficha personalizada

Una de las instrucciones de diseño de las aplicaciones de Office es que los usuarios siempre deberían tener control de su interfaz de usuario. Para agregar esta capacidad en los paneles de acciones, puede agregar botones que muestren y oculten cada panel de acciones en una ficha personalizada de la cinta de opciones. Para crear una ficha personalizada, agregue un elemento Cinta (diseñador visual) al proyecto. El diseñador ayuda a agregar y colocar controles, a establecer las propiedades del control y a controlar los eventos de control.

Para crear una ficha personalizada

En el menú Proyecto, haga clic en Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione Cinta (diseñador visual).
Cambie el nombre de la nueva cinta de opciones por MyRibbon y haga clic en Agregar.

El archivo MyRibbon.cs o MyRibbon.vb se abre en el diseñador de la cinta de opciones y muestra una ficha y un grupo predeterminados.
En el diseñador de la cinta de opciones, haga clic en grupo1.
En la ventana Propiedades , establezca Etiqueta en Actions Pane Manager.
Desde la ficha Controles de la cinta de opciones de Office del Cuadro de herramientas, arrastre un botón a grupo1.
Haga clic en button1 para seleccionarlo.
En la ventana Propiedades , establezca Etiqueta en Show Actions Pane 1.
Agregue un segundo botón a grupo1y establezca la propiedad Etiqueta en Show Actions Pane 2.
Desde la ficha Controles de la cinta de opciones de Office del Cuadro de herramientas, arrastre un control ToggleButton a grupo1.
Establezca la propiedad Etiqueta en Hide Actions Pane.

Ocultar y mostrar paneles de acciones con botones de la ficha personalizada

El último paso consiste en agregar código que responda al usuario. Agregue controladores de eventos para los eventos Click de los dos botones y el evento Click del botón de alternancia. Agregue código a estos controladores de eventos que oculten y muestren los paneles de acciones.

Para ocultar y mostrar paneles de acciones con botones de la ficha personalizada

En el Explorador de soluciones, haga clic con el botón secundario en el archivo MyRibbon.cs o MyRibbon.vb y, a continuación, haga clic en Ver código.

Agregue el siguiente código al comienzo de la clase MyRibbon. Este código crea dos objetos de panel de acciones.

Dim actionsPane1 As New ActionsPaneControl1()
Dim actionsPane2 As New ActionsPaneControl2()

ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();

En C#, debe agregar los controladores de eventos siguientes al constructor. Para obtener más información sobre cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en Visual Studio Tools para Office.

this.button1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button1_Click);
this.button2.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button2_Click);
this.toggleButton1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.toggleButton1_Click);
this.Load += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs>
        (this.MyRibbon_Load);

Agregue el código siguiente al evento MyRibbon_Load. Este código agrega los objetos de panel de acciones a la colección Microsoft.Office.Tools.ActionsPane.Controls del panel de acciones y oculta los objetos de la vista.

Private Sub MyRibbon_Load(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs) _
        Handles MyBase.Load

    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
    actionsPane1.Hide()
    actionsPane2.Hide()
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
End Sub

private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
{
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
    actionsPane1.Hide();
    actionsPane2.Hide();
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
}

Agregue los tres métodos siguientes de controlador de eventos a la clase MyRibbon. Estos métodos controlan los eventos Click de los dos botones y el evento Click del botón de alternancia. Los controladores de eventos de button1 y button2 muestran paneles de acciones alternativos. El controlador de eventos de toggleButton1 muestra y oculta el panel de acciones activo.

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button1.Click
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane2.Hide()
    actionsPane1.Show()
End Sub

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button2.Click

    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane1.Hide()
    actionsPane2.Show()

End Sub


Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles ToggleButton1.Click

    If ToggleButton1.Checked Then
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
    Else
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    End If

End Sub

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane2.Hide();
    actionsPane1.Show();
}

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();

}

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    if (toggleButton1.Checked == true)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    }
    else
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    }

}

Probar la ficha personalizada

Al ejecutar el proyecto, Excel se inicia. En la cinta de opciones aparece la ficha Complementos. Haga clic en los botones de Add-Ins mostrar y ocultar los paneles de acciones.

Para probar la ficha personalizada

Presione F5 para ejecutar el proyecto.
Haga clic en la ficha Complementos.
En el grupo Custom Actions Pane Manager, haga clic en Show Actions Pane 1.

El panel de acciones aparece y muestra la etiqueta Actions Pane 1.
Haga clic en Show Actions Pane 2.

El panel de acciones aparece y muestra la etiqueta Actions Pane 2.
Haga clic en Hide Actions Pane.

Los paneles de acciones ya no están visibles.

Pasos siguientes

Puede aprender más acerca de la personalización de la interfaz de usuario de Office en estos temas:

Agregar una interfaz de usuario basada en contexto a cualquier personalización de nivel de documento. Para obtener más información, vea Información general sobre paneles de acciones.
Extender un formulario estándar o personalizado de Microsoft Office Outlook. Para obtener más información, vea Tutorial: Diseñar un área de formulario de Outlook.