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

Artículo
08/10/2011

En este tutorial se muestra cómo crear un complemento en el nivel de la aplicación para Microsoft Office Project. Las características que se crean en este tipo de solución están disponibles para la propia aplicación, con independencia de qué proyectos están abiertos. Para obtener más información, vea Información general sobre el desarrollo de soluciones de Office.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de aplicación para Project 2007 y Project 2010. Para obtener más información, vea 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 Project.
Escribir código que usa el modelo de objetos de Project para agregar una tarea a un nuevo proyecto.
Generar y ejecutar el proyecto para probarlo.
Limpiar el proyecto completado 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:

Una edición de Visual Studio 2010 que incluye las herramientas para desarrolladores de Microsoft Office. Para obtener más información, vea [Configurar un equipo para desarrollar soluciones de Office](bb398242\(v=vs.100\).md).

Microsoft Office Project 2007 o Project 2010.

Crear el proyecto

Para crear un nuevo proyecto en Visual Studio

Inicie Visual Studio.
En el menú Archivo, elija Nuevo y haga clic en Proyecto.
En el recuadro de plantillas, expanda Visual C# o Visual Basic y, a continuación, expanda Office.
Bajo el nodo Office expandido, seleccione 2007 si tiene Project 2007 instalado o seleccione 2010 si tiene Project 2010 instalado.
En la lista de plantillas de proyecto, seleccione Complemento de Project 2007 o Complemento de Project 2010.
En el cuadro Nombre, escriba FirstProjectAddIn.
Haga clic en Aceptar.

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 nueva tarea a un proyecto. 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 Project. Para obtener más información, vea Programar complementos de nivel de aplicación. El resto de la clase ThisAddIn se define en un archivo de código oculto que no 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. 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 los proyectos de Office.

Para agregar una tarea a un nuevo proyecto

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.

Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
    Dim newTask As MSProject.Task
    newTask = pj.Tasks.Add _
    ("This text was added by using code")
    newTask.Start = DateTime.Now
    newTask.Duration = "3"
    newTask.ResourceNames = "Rob Caron, Kelly Krout"
End Sub

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 objetos siguientes:

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 del evento NewProject. El parámetro pj es un objeto Microsoft.Office.Interop.MSProject.Project, que representa el proyecto. Para obtener más información, vea Soluciones de Project.

Si utiliza 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);
```

Probar el proyecto

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

Para probar el proyecto

Presione F5 para generar y ejecutar el proyecto. Se inicia Microsoft Project y se abre automáticamente un nuevo proyecto en blanco.

Al generar el proyecto, el código se genera 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 Project 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.
Compruebe que se agrega una nueva tarea al proyecto en blanco.
Compruebe que el texto siguiente aparece en el campo Nombre de tarea de la tarea.

Este texto se agregó mediante código.
Cierre Microsoft Project.

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 abra Microsoft Project 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 Project, puede obtener más información sobre la programación de complementos en estos temas:

Tareas de programación generales que puede realizar en los complementos para Project: Programar complementos de nivel de aplicación.
Utilizar el modelo de objetos de Project: Soluciones de Project.
Generar y depurar los complementos en el nivel de la aplicación para Project: Generar y depurar soluciones de Office.
Implementar complementos en el nivel de la aplicación para Project: Implementar soluciones de Office.