Compartir a través de

Tutorial: Crear el primer complemento de VSTO para Project

  • Artículo

Este tutorial muestra cómo crear un complemento de VSTO para Microsoft Office Project. Las características que cree en este tipo de solución estarán disponibles para la propia aplicación, con independencia de los proyectos que estén abiertos. Para obtener más información, consulte Información general sobre el desarrollo de soluciones de Office (VSTO).

Aplicación: la información de este tema se aplica a los proyectos de complemento de VSTO para Project. Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto de Office.

En este tutorial se muestran las tareas siguientes:

  • Crear un proyecto de complemento de VSTO de Project.

  • Escribir código que usa el modelo de objetos de Project para agregar una tarea a un nuevo proyecto.

  • Compilar y ejecutar el proyecto para probarlo.

  • Limpiar el proyecto completado para que el complemento de VSTO deje de ejecutarse automáticamente en el equipo de desarrollo.

    Nota:

    Es posible que tu 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 se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Requisitos previos

Necesitará los componentes siguientes para completar este tutorial:

Creación del proyecto

Para crear un nuevo proyecto en Visual Studio

  1. Inicie Visual Studio.

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

  3. En el panel de plantillas, expanda Visual C# o Visual Basicy luego expanda Office/SharePoint.

  4. En el nodo Office/SharePoint expandido, seleccione el nodo Complementos de Office .

  5. En la lista de plantillas de proyecto, seleccione Complemento de Project 2010 o Complemento de Project 2013.

  6. En el cuadro Nombre , escriba FirstProjectAddIn.

  7. Haga clic en OK.

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

Escribir código que agrega una nueva tarea a un proyecto

A continuación, agregue código al archivo de código ThisAddIn. El nuevo código usa el modelo de objetos de Project para agregar una tarea a un proyecto. De forma predeterminada, el archivo de código ThisAddIn contiene el siguiente código generado:

  • Una definición parcial de la clase ThisAddIn . Esta clase ofrece un punto de entrada para el código y acceso al modelo de objetos de Project. Para obtener más información, consulte Programación de complementos de VSTO. El resto de la clase ThisAddIn se define en un archivo de código oculto que no se debe modificar.

  • Los controladores de eventos ThisAddIn_Startup y ThisAddIn_Shutdown . Se llama a estos controladores de eventos cuando Project carga y descarga el complemento de VSTO. Use estos controladores de eventos para inicializar el complemento de VSTO cuando se cargue y para limpiar los recursos que usa el complemento de VSTO cuando se descargue. Para obtener más información, consulte Events in Office Projects.

Para agregar una tarea a un nuevo proyecto

  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 NewProject de la clase Microsoft.Office.Interop.MSProject.Application.

    Cuando el usuario crea un nuevo proyecto, este controlador de eventos agrega una tarea al proyecto.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    Para modificar el proyecto, este ejemplo de código usa los siguientes objetos:

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

  • El parámetro pj del controlador de eventos para el evento NewProject. El parámetro pj es un objeto Microsoft.Office.Interop.MSProject.Project, que representa el proyecto. Para obtener más información, consulte Soluciones de Project.

  1. Si está usando C#, agregue el siguiente código al controlador de eventos ThisAddIn_Startup . Este código conecta el controlador de eventos Application_Newproject con el evento NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

Prueba del proyecto

Al compilar y ejecutar el proyecto, compruebe que la nueva tarea aparece en el nuevo proyecto resultante.

Para probar el proyecto

  1. Presione F5 para compilar y ejecutar el proyecto. Microsoft Project inicia y abre automáticamente un nuevo proyecto en blanco.

    Al compilar el proyecto, el código se compila en un ensamblado que se incluye en la carpeta de salida de compilación del proyecto. Visual Studio crea también un conjunto de entradas del registro que permiten que Project detecte y cargue el complemento de VSTO, y establece la configuración de seguridad en el equipo de desarrollo para permitir la ejecución del complemento de VSTO. Para obtener más información, consulte Información general del proceso de compilación de soluciones de Office.

  2. Compruebe que se ha agregado una nueva tarea al proyecto en blanco.

  3. Compruebe que aparece el texto siguiente en el campo Nombre de tarea de la tarea.

    Este texto se agregó mediante código.

  4. Cierre Microsoft Project.

Limpiar el proyecto

Cuando termine de desarrollar un proyecto, quite el ensamblado del complemento de VSTO, las entradas del registro y la configuración de seguridad del equipo de desarrollo. De lo contrario, el complemento de VSTO se ejecutará cada vez que abra Microsoft Project en el equipo de desarrollo.

Para limpiar el proyecto

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

Pasos siguientes

Ahora que ha creado un complemento básico de VSTO para Project, puede obtener más información sobre cómo desarrollar complementos de VSTO en estos temas:

Contenido relacionado