Passo a passo: Criando O primeiro nível do aplicativo Add-in do projeto
Essa explicação passo a passo mostra como criar um suplemento ao nível para Microsoft Office.Os recursos que você criou em este tipo de solução estão disponíveis para o próprio aplicativo, independentemente de qual os projetos estão abertos.Para obter mais informações, consulte Visão geral de desenvolvimento de soluções do Office.
Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Project 2013 e Project 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.
Essa explicação passo a passo mostra as seguintes tarefas:
Criando um projeto do suplemento ao projeto.
Escrevendo código que usa o modelo de objeto do projeto para adicionar uma tarefa para um novo projeto.
Compilação e execução do projeto testá-lo.
Limpando o projeto terminado de modo que o suplemento não executa automaticamente no seu computador de desenvolvimento.
Observação |
---|
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações de Visual Studio. |
Pré-requisitos
Para completar este passo-a-passo, são necessários os seguintes componentes:
-
Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).
- Project 2013 ou Project 2010.
Criando o projeto
Para criar um novo projeto no Visual Studio
Inicie o Visual Studio
No menu File, aponte para New, e em seguida, clique em Project.
Em o painel de modelos, expanda Visual C# ou Visual Basicem seguida, expanda Office/SharePoint.
Sob o nó expandido de Office/SharePoint , selecione o nó de Suplementos do Office .
Em a lista de modelos de projeto, de Suplemento do Project 2010 selecione ou de Suplemento do Project 2013.
Em a caixa de Nome , digite FirstProjectAddIn.
Clique em OK.
Visual Studio criar o projeto de FirstProjectAddIn e abre o arquivo de código de ThisAddIn no editor.
Escrevendo código que adiciona uma nova tarefa a um projeto
Em seguida, adicione o código ao arquivo de código de ThisAddIn.O novo código usa o modelo de objeto do projeto para adicionar uma nova tarefa a um projeto.Por padrão, o arquivo de código de ThisAddIn contém o seguinte código gerado:
Uma definição de classe parcial de ThisAddIn .Essa classe fornece uma ponto de entrada para seu código e fornece acesso para o modelo de objeto do projeto.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação..O restante da classe de ThisAddIn é definido em um arquivo oculto de código que você não deve alterar.
os manipuladores de eventos de ThisAddIn_Startup e de ThisAddIn_Shutdown .Esses manipuladores de eventos são chamados quando o projeto é carregado e descarrega o suplemento.Use esses manipuladores de eventos para inicializar o suplemento quando ele for carregado, e para limpar os recursos usados pelo suplemento quando é descarregado.Para obter mais informações, consulte Eventos em projetos do Office.
Para adicionar uma tarefa para um novo projeto
Em o arquivo de código de ThisAddIn, adicione o seguinte código à classe de ThisAddIn .Esse código define um manipulador de eventos para o evento de NewProject da classe de Microsoft.Office.Interop.MSProject.Application .
quando o usuário cria um novo projeto, este manipulador de eventos adiciona uma tarefa ao projeto.
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 alterar o projeto, esse uso do código de exemplo os seguintes objetos:
O campo de Application da classe de ThisAddIn .O campo de Application retorna um objeto de Microsoft.Office.Interop.MSProject.Application , que representa a instância atual do projeto.
O parâmetro de pj do manipulador de eventos para o evento de NewProject .O parâmetro de pj é um objeto de Microsoft.Office.Interop.MSProject.Project , que representa o projeto.Para obter mais informações, consulte Soluções de projeto.
Se você estiver usando C#, adicione o seguinte código ao manipulador de eventos de ThisAddIn_Startup .Esse código conecta o manipulador de eventos de Application_Newproject com o evento de NewProject .
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
Testar o projeto.
Quando você compilar e executar o projeto, verifique se a nova tarefa aparece no novo projeto resultante.
para testar o projeto
Pressione F5 para compilar e executar o projeto.Microsoft Project inicia e automaticamente abre um novo projeto em branco.
Quando você criar o projeto, o código é compilado em um assembly que é incluído na pasta de saída de compilação para o projeto.O Visual Studio também cria um conjunto de entradas do Registro que permitem ao projeto descobrir e carregar o suplemento, e configurar as configurações de segurança no computador de desenvolvimento para ativar o suplemento a execução.Para obter mais informações, consulte Office Solution Build Process Overview.
Verifique que uma nova tarefa é adicionada ao projeto em branco.
Verifique se o seguinte texto apareça no campo de Nome da tarefa de tarefas.
Esse texto foi adicionado usando código.
Feche o Microsoft Project.
limpando o projeto
Quando você terminar de desenvolver um projeto, remova o assembly, as entradas de Registro, e as configurações de segurança do suplemento do seu computador de desenvolvimento.Caso contrário, o suplemento será executado sempre que você abrir Microsoft Project no computador de desenvolvimento.
Para limpar o seu projeto
- Em o Visual Studio, no menu de Compilar , clique Limpar solução.
Próximas etapas
Agora que você criou um suplemento básico para o nível do projeto, você pode aprender mais sobre como desenvolver suplementos de esses tópicos:
Tarefas básicas de programação que você pode executar de suplementos para o projeto: Os suplementos de nível de aplicativo de programação..
Usando o modelo de objeto de projeto: Soluções de projeto.
Suplementos em nível de compilação e de depuração para o projeto: Construindo soluções do Office.
Implantando suplementos do nível para o projeto: Implantando uma solução do Office.
Consulte também
Conceitos
Outros recursos
Os suplementos de nível de aplicativo de programação.
Construindo soluções do Office