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

Artigo
02/25/2013

Essa explicação passo a passo de introdução mostra como criar um suplemento ao nível para o Microsoft Office Word.Os recursos que você criou em este tipo de solução estão disponíveis para o próprio aplicativo, independentemente de qual documentos estão abertos.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Word 2013 e Word 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 a palavra.
Escrevendo código que usa o modelo de objeto de palavras para adicionar texto em um documento enquanto é salvo.
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).

Word 2013 ou Word 2010.

Criando o projeto

Para criar um novo suplemento a palavra 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, selecione Suplemento do Word 2010 ou Suplemento do Word 2013.
Em a caixa de Nome , digite FirstWordAddIn.
Clique em OK.

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

Escrevendo código para adicionar texto ao documento salvo

Em seguida, adicione o código ao arquivo de código de ThisAddIn.O novo código usa o modelo de objeto de palavras para adicionar texto de texto constante para cada documento salvo.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 ao modelo de objeto de palavras.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 a palavra carregam e descarregam 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 um parágrafo de texto ao documento salvo

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

Quando o usuário salva um documento, o manipulador de eventos adicionar o 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 de 1 para acessar o primeiro parágrafo na coleção de Paragraphs .Embora Visual Basic e visual C# usam 0 em matrizes, os limites da matriz mais baixo da maioria das coleções no modelo de objeto do word é 1.Para obter mais informações, consulte Escrevendo código em soluções do Office.

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

Para alterar o documento enquanto é salvo, o uso dos exemplos de código anterior os seguintes objetos:

O campo de Application da classe de ThisAddIn .O campo de Application retorna um objeto de Microsoft.Office.Interop.Word.Application , que representa a instância atual da palavra.
O parâmetro de Doc do manipulador de eventos para o evento de DocumentBeforeSave .O parâmetro de Doc é um objeto de Microsoft.Office.Interop.Word.Document , que representa o documento salvo.Para obter mais informações, consulte Visão geral do modelo de objeto do Word.

Testar o projeto.

para testar o projeto

Pressione F5 para compilar e executar o projeto.

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 a palavra para 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 Construindo soluções do Office.
Em as palavras, salve o documento ativo.
Verifique se o seguinte texto é adicionado ao documento.

Esse texto foi adicionado usando código.
Feche a palavra.

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 continuará a ser executado sempre que você abrir palavra em seu computador de desenvolvimento.

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

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 para palavras, você pode aprender mais sobre como desenvolver suplementos de esses tópicos:

Tarefas básicas de programação que você pode executar de suplementos: Os suplementos de nível de aplicativo de programação..
Tarefas de programação que são específicas exprimir suplementos: Soluções do Word.
Usando o modelo de objeto do word: Visão geral do modelo de objeto do Word.
Personalizando interface de usuário da palavra, por exemplo, adicionando um guia personalizado à fita ou criando seu próprio painel de tarefa personalizada: Personalização de interface do usuário do Office.
Suplementos em nível de compilação e de depuração para palavra: Construindo soluções do Office.
Implantando suplementos do nível para palavra: Implantando uma solução do Office.