Compartir a través de


Ejemplo Runtime Services

Actualización: noviembre 2007

Nota:

Este ejemplo sólo se ejecuta en Microsoft Office Excel 2007.

En este ejemplo se muestra cómo crear una personalización de la cinta de opciones y un panel de tareas personalizado para Microsoft Office Excel 2007 implementando interfaces de extensibilidad en un complemento.

En este ejemplo se implementan las siguientes interfaces de extensibilidad para crear el panel de tareas personalizado:

  • Microsoft.Office.Core.ICustomTaskPaneConsumer. En el ejemplo se implementa esta interfaz para crear un panel de tareas que contiene un cuadro de texto y un botón. Cuando el usuario hace clic en el botón, la cadena en el cuadro de texto se agrega al intervalo que tiene el foco en el libro activo.

  • Microsoft.Office.Core.IRibbonExtensibility. En el ejemplo se implementa esta interfaz para agregar un botón de alternancia en el que el usuario puede hacer clic para mostrar u ocultar el panel de tareas.

Para obtener información sobre la instalación del proyecto de ejemplo en el equipo, vea Cómo: Instalar y utilizar archivos de ejemplo de la Ayuda.

Nota:

Si bien en este ejemplo se utilizan interfaces de extensibilidad para crear una personalización de la cinta de opciones y un panel de tareas personalizado, Visual Studio Tools para Office proporciona clases y diseñadores para este propósito. Estos diseñadores y clases simplifican el trabajo con estas características. Para obtener más información, vea diseñador de la cinta de opciones e Información general sobre los paneles de tareas personalizados.

Nota de seguridad:

Este ejemplo de código está pensado para explicar un concepto y sólo muestra el código relevante para ese concepto. Es posible que no cumpla los requisitos de seguridad de un entorno específico y no se debe usar exactamente como en el ejemplo. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más sólidos y seguros. Microsoft proporciona este código de ejemplo "TAL CUAL" sin ninguna garantía.

Download sample

Para ejecutar este ejemplo

  1. Presione F5.

  2. En la cinta de opciones, haga clic en la ficha RuntimeServices.

  3. En el grupo VSTO, haga clic en el botón TaskPane.

    Compruebe que aparece el panel de tareas Contoso.

  4. En el panel de tareas, escriba un texto en el cuadro de texto.

  5. Haga clic en el botón Insertar.

    Compruebe que el texto que escribió en el cuadro de texto se ha agregado a la celda que tiene el foco en la hoja de cálculo activa.

  6. En la cinta de opciones, haga de nuevo clic en el botón TaskPane.

    Compruebe que se cierra el panel de tareas.

Requisitos

Este ejemplo requiere las aplicaciones siguientes:

  • Visual Studio Tools para Office.

  • Microsoft Office Excel 2007.

Demostraciones

En este ejemplo se muestran los conceptos siguientes:

  • Crear una personalización de la cinta de opciones implementando la interfaz Microsoft.Office.Core.IRibbonExtensibility en un complemento.

  • Crear un panel de tareas personalizado implementando la interfaz Microsoft.Office.Core.ICustomTaskPaneConsumer en un complemento.

  • Mostrar y ocultar el panel de tareas personalizado de un botón de alternancia en la cinta de opciones.

  • Insertar en la hoja de cálculo activa el texto escrito en el panel de tareas personalizado.

Vea también

Tareas

Ejemplo de demostración Task Pane

Conceptos

Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad

diseñador de la cinta de opciones

Información general sobre los paneles de tareas personalizados

Otros recursos

Ejemplos en el nivel de documento