Compartir a través de

Tutorial: Crear el primer complemento en el nivel de la aplicación para PowerPoint

  • Artículo

Actualización: Julio de 2008

Se aplica a

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

Tipo de proyecto

  • Proyectos de nivel de aplicación

Versión de Microsoft Office

  • PowerPoint 2007

  • PowerPoint 2003

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 un complemento en el nivel de la aplicación para Microsoft Office PowerPoint. Las características que se crean en este tipo de solución están disponibles para la propia aplicación, con independencia de qué presentaciones están abiertas. Para obtener más información, vea Información general sobre el desarrollo de soluciones de Office.

Este tutorial ilustra las tareas siguientes:

  • Crear un proyecto de complemento de PowerPoint para PowerPoint 2003 o PowerPoint 2007.

  • Escribir código que utiliza el modelo de objetos de PowerPoint para agregar un cuadro de texto a cada nueva diapositiva.

  • Generar y ejecutar el proyecto para probarlo.

  • Limpiar el proyecto para que el complemento ya no se ejecute automáticamente en el equipo de desarrollo.

Nota:

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice 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).

  • PowerPoint 2003 o PowerPoint 2007.

De manera predeterminada, Visual Studio Tools para Office se instala con las versiones enumeradas de Visual Studio. Para comprobar si está instalado en su equipo, vea Instalar Visual Studio Tools para Office.

Creación del proyecto

Para crear un nuevo proyecto

  1. Inicie Visual Studio.

  2. En el menú Archivo, elija Nuevo y haga clic en Proyecto.

  3. En el panel Tipos de proyecto, expanda Visual C# o Visual Basic y, a continuación, expanda Office.

  4. Seleccione la carpeta 2007 si está desarrollando un complemento para PowerPoint 2007; seleccione la carpeta 2003 si está desarrollando un complemento para PowerPoint 2003.

  5. En el panel Plantillas, seleccione Complemento de PowerPoint 2007 o Complemento de PowerPoint 2003.

  6. En el cuadro Nombre, escriba FirstPowerPointAddIn.

  7. Haga clic en Aceptar.

    Visual Studio crea el proyecto FirstPowerPointAddIn y abre el archivo de código ThisAddIn en el editor.

Escribir código para agregar texto a cada nueva diapositiva

A continuación, agregue código al archivo de código ThisAddIn. Este nuevo código utiliza el modelo de objetos de PowerPoint para agregar un cuadro de texto a cada nueva diapositiva. De forma predeterminada, el archivo de código ThisAddIn contiene el código generado siguiente:

  • Una definición parcial de la clase ThisAddIn. Esta clase proporciona un punto de entrada para el código y proporciona acceso al modelo de objetos de PowerPoint. Para obtener más información, vea Elemento host AddIn. El resto de la clase ThisAddIn se define en un archivo de código oculto que no debe modificar.

  • Los controladores de eventos ThisAddIn_Shutdown y ThisAddIn_Startup. Se llama a estos controladores de eventos cuando PowerPoint carga y descarga el complemento. Use estos controladores de eventos para inicializar el complemento cuando éste se cargue y para limpiar los recursos cuando se descargue. Para obtener más información, vea Eventos de proyectos de Visual Studio Tools para Office.

Para agregar un cuadro de texto a cada nueva diapositiva

  1. En el archivo de código ThisAddIn, agregue el código siguiente a la clase ThisAddIn. Este código define un controlador de eventos para el evento PresentationNewSlide de la clase Microsoft.Office.Interop.PowerPoint.Application.

    Cuando el usuario agrega una nueva diapositiva a la presentación activa, este controlador de eventos agrega un cuadro de texto a la parte superior de la nueva diapositiva y agrega texto al cuadro de texto.

    Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
    Handles Application.PresentationNewSlide
    Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
End Sub

    void Application_PresentationNewSlide(PowerPoint.Slide Sld)
{
    PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
}

  2. Si utiliza C#, agregue el siguiente código al controlador de eventos ThisAddIn_Startup. Este código es necesario para conectar el controlador de eventos Application_PresentationNewSlide al evento PresentationNewSlide.

    this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);

Para modificar cada nueva diapositiva, los ejemplos de código anteriores utilizan los objetos siguientes:

  • El campo Application de la clase ThisAddIn. El campo Application devuelve un objeto Microsoft.Office.Interop.PowerPoint.Application que representa la instancia actual de PowerPoint.

  • El parámetro Sld del controlador del evento PresentationNewSlide. El parámetro Sld es un objeto Microsoft.Office.Interop.PowerPoint.Slide que representa la nueva diapositiva. Para obtener más información, vea Soluciones de PowerPoint.

Probar el proyecto

Al generar y ejecutar el proyecto, compruebe que el cuadro de texto aparece en las nuevas diapositivas que agrega a la presentación.

Para probar el proyecto

  1. Presione F5 para generar y ejecutar el proyecto.

    Al generar el proyecto, el código se compila en un ensamblado que se incluye en la carpeta de resultado de compilación del proyecto. Visual Studio también crea un conjunto de entradas del Registro que permiten que PowerPoint detecte y cargue el complemento, y establece la configuración de seguridad en el equipo de desarrollo a fin de permitir la ejecución del complemento. Para obtener más información, vea Información general acerca del proceso de compilación de soluciones de Office.

  2. En PowerPoint, agregue una nueva diapositiva a la presentación activa.

  3. Compruebe que el texto siguiente se agrega a un nuevo cuadro de texto en la parte superior de la diapositiva.

    Este texto se agregó mediante código.

  4. Cierre PowerPoint.

Limpiar el proyecto

Al terminar de desarrollar un proyecto, quite el ensamblado de complemento, las entradas del Registro y la configuración de seguridad del equipo de desarrollo. De lo contrario, el complemento se ejecutará cada vez que abra PowerPoint en el equipo de desarrollo.

Para limpiar el proyecto

  • En el menú Generar de Visual Studio, haga clic en Limpiar solución.

Pasos siguientes

Ahora que ha creado un complemento básico en el nivel de la aplicación para PowerPoint, puede obtener más información sobre la programación de complementos en estos temas:

Vea también

Conceptos

Programar complementos de nivel de aplicación

Soluciones de PowerPoint

Personalización de la interfaz de usuario de Office

Información general sobre las plantillas de proyecto en Visual Studio Tools para Office

Referencia

Plantillas de proyecto de complemento de Microsoft Office 2003

Plantillas de proyecto de complemento de Microsoft Office 2007

Otros recursos

Generar y depurar soluciones de Office

Implementar soluciones de Office

Historial de cambios

Fecha

Historial

Motivo

Julio de 2008

Se ha agregado un tema.

Mejora de la información.