Demonstra Passo a passo: Criando o primeiro nível do aplicativo Add-in para o Word

Artigo
08/08/2011

Este passo a passo introdutória mostra como criar um suplemento em nível de aplicativo para o Word de Microsoft Office. Os recursos que você criar nesse tipo de solução estão disponíveis para o aplicativo propriamente dito, independentemente de quais documentos estão abertos.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

Criando um projeto de suplemento do Word.
Escrever o código que usa o modelo de objeto do Word para adicionar texto a um documento quando ele for salvo.
A criação e execução do projeto para testá-lo.
Limpando o projeto concluído para que o suplemento não executa mais automaticamente no 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 do Visual Studio.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Word 2007 ou Word 2010.

Creating the Project

Para criar um novo Word add-in do projeto em Visual Studio

Start Visual Studio.
On the File menu, point to New, and then click Project.
No painel templates, expanda Visual C# ou Visual Basice em seguida, expanda Office.
Em expandida Office nó, selecione o 2007 se você tiver o Word 2007 instalado, ou selecione o 2010 o nó se você tiver Word 2010 instalado.
Na lista de modelos de projeto, selecione suplemento do Word 2007 ou Word Add-in 2010.
No nome , digite FirstWordAddIn.
Click OK.

Visual Studiocria o FirstWordAddIn de projeto e abre o arquivo de código ThisAddIn no editor.

Escrever código para adicionar texto a documento salvo

Em seguida, adicione o código para o arquivo de código ThisAddIn. O novo código usa o modelo de objeto do Word para adicionar o timbre para cada documento salvo. Por padrão, o arquivo de código ThisAddIn contém o seguinte código gerado:

Uma definição parcial da ThisAddIn classe. Essa classe fornece um ponto de entrada para o seu código e fornece acesso ao modelo de objeto do Word. For more information, see Os suplementos de nível de aplicativo de programação.. O restante do ThisAddIn classe é definida em um arquivo de código oculto que você não deve modificar.
O ThisAddIn_Startup e ThisAddIn_Shutdown manipuladores de evento. Esses manipuladores de eventos são chamados quando o Word carrega e descarrega o suplemento. Use esses manipuladores de evento para inicializar seu suplemento quando ele for carregado e limpar os recursos usados por seu suplemento, quando ela é descarregada. For more information, see Eventos em projetos do Office.

Para adicionar um parágrafo de texto para o documento salvo

No arquivo de código ThisAddIn, adicione o seguinte código para o ThisAddIn classe. O novo código define um manipulador de eventos para o DocumentBeforeSave o evento, que é disparado quando um documento for salvo.

Quando o usuário salva um documento, o manipulador de evento adiciona novo texto no início do documento.

Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub

void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}

Observação
Esse código usa um valor de índice 1 para acessar o primeiro parágrafo do Paragraphs coleção. Embora Visual Basic e C# Visual usarem arrays baseados em 0, os limites inferiores da matriz da maioria das coleções no modelo de objeto do Word é 1. For more information, see Programação com Visual Basic vs. C# Visual em soluções do Office.

Se você estiver usando o C#, adicione o seguinte código necessário para a ThisAddIn_Startup manipulador de eventos. Esse código é usado para conectar-se a Application_DocumentBeforeSave o manipulador de eventos com o DocumentBeforeSave de evento.
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```

Para modificar o documento quando ele for salvo, os exemplos de código anterior usam os seguintes objetos:

O Application campo de ThisAddIn classe. O Application campo retorna um Microsoft.Office.Interop.Word.Application o objeto, que representa a instância atual do Word.
O Doc parâmetro do manipulador de eventos para o DocumentBeforeSave de evento. O Doc parâmetro é um Microsoft.Office.Interop.Word.Document o objeto, que representa o documento salvo. For more information, see Palavra Overview do modelo de objeto.

Testing the Project

Para testar o projeto.

Pressione F5 para criar e executar seu projeto.

Quando você constrói o projeto, o código é compilado em um assembly que está incluído na pasta de saída de compilação do projeto. Visual Studio também cria um conjunto de entradas de registro que permitem que o Word detectar e carregar o suplemento, e ele define as configurações de segurança no computador de desenvolvimento para ativar o add-in executar. For more information, see Visão Geral do Processo de Compilação de uma Solução Office.
No Word, salve o documento ativo.
Verifique se o seguinte texto é adicionado ao documento.

Este texto foi adicionado por meio de código.
Feche o Word.

Limpando o projeto.

Quando terminar de desenvolver um projeto, remova o assembly do suplemento, entradas do registro e as configurações de segurança do seu computador de desenvolvimento. Caso contrário, o add-in continuará a ser executado toda vez que abrir o Word em seu computador de desenvolvimento.

Para limpar o projeto concluído em seu computador de desenvolvimento

Em Visual Studio, sobre o Build menu, clique em Limpar solução.

Próximas etapas

Agora que você criou um suplemento do nível de aplicativo básico para o Word, você pode aprender mais sobre como desenvolver suplementos com estes tópicos:

Tarefas de programação gerais que você pode executar no add-ins: Os suplementos de nível de aplicativo de programação..
Programação de tarefas que são específicas aos suplementos do Word: Soluções do Word.
Usando o modelo de objeto do Word: Palavra Overview do modelo de objeto.
Personalizar a interface do usuário do Word, por exemplo, adicionando uma guia personalizada à Faixa de opções ou criando seu próprio painel de tarefas personalizado: Personalização de interface do usuário do Office.
Criação e depuração de suplementos em nível de aplicativo para o Word: Criação e depuração de soluções do Office.
Implantando os suplementos de nível de aplicativo para o Word: Implantar soluções do Office.