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

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Versão do Microsoft Office Word 2007 Word 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo introdução mostra como criar um aplicativo-nível Adicionar - in para o Microsoft Office Word.Os recursos que você criar nesse tipo de solução estão disponíveis para o próprio aplicativo, independentemente do que os documentos são Abrir.

Essa explicação passo a passo ilustra as seguintes tarefas:

• Criar uma palavra Adicionar no projeto para o Word 2003 ou no Word 2007.

• Escrever código que usa o modelo de objeto do Word para adicionar texto a um documento quando ele for salvo.

• Criar e Executando o projeto para testá-lo.

• Limpando o projeto concluído para que o Adicionar-in não executada automaticamente no seu computador de desenvolvimento.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de 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

Para completar este passo a passo, são necessários os seguintes componentes:

• Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

• Word 2003 ou no Word 2007.

Por padrão, Ferramentas do Visual Studio para o Office é instalado com as versões listadas do Visual Studio.Para Marcar se ele está instalado no computador, Marcar Instalando o Visual Studio Tools para Office.

Criando o projeto

Para criar uma nova palavra Adicionar no projeto no Visual Studio

1. Inicie o Visual Studio

2. No menu File, aponte para New, e em seguida, clique em Project.

3. No painel de A Projeto Types, Expandirir Visual C# ou do Visual Basic e em seguida, Expandirir Office.

4. Selecionar a pasta de De 2007 se você estiver desenvolvendo um Word 2007 Adicionar - in, ou Selecionar a pasta de 2003 se você estiver desenvolvendo um Word 2003 Adicionar - in.

5. No painel Modelos , Selecionar Word 2003 Adicionar - em ou Word 2007 Adicionar -.

6. Na caixa Nome, tipo FirstWordAddIn.

7. Clique em OK.

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

Escrevendo código para adicionar texto ao documento salvo

Avançar, adicione código para o arquivo de código ThisAddIn.O novo código usa o modelo de objeto do Word para adicionar texto clichê 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 classe ThisAddIn.Essa classe fornece um ponto de entrada para o seu código e fornece Acessar ao modelo de objeto do Word.For more information, see Item de host addIn.O restante da classe ThisAddIn é definido em um arquivo de código oculto que você não deve modificar.

• O ThisAddIn_Startup e ThisAddIn_Shutdown manipuladores de eventos.Esses manipuladores de eventos são chamados quando o Word carrega e descarrega o Adicionar - in.Use esses manipuladores de eventos ao inicializar o Adicionar-in quando ele for carregado e para Apagar recursos utilizados pelo seu suplemento quando ele for descarregado.For more information, see O Visual Studio Tools for Office Projeto eventos.

Para adicionar um parágrafo de texto ao documento salvo

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

   Quando o usuário salva um documento, o manipulador de eventos adiciona novo texto no Iniciar 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:
   Este código usa um valor de índice 1 para acessar o primeiro parágrafo a Coleção Paragraphs.Apesar de Visual Basic e Visual C# usarem matrizes baseadas em 0, dos limites de matriz inferiores da maioria das coleções do modelo Word objeto do é 1.For more information, see Programação com Visual Basic vs. C#.

2. Se você estiver usando C#, Adicionar necessário do seguinte código ao manipulador de eventos ThisAddIn_Startup.Esse código é usado para conectar o manipulador de eventos Application_DocumentBeforeSave com o evento DocumentBeforeSave.

   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 campo Application da classe ThisAddIn.O campo Application retorna um objeto de Microsoft.Office.Interop.Word.Application, que representa a instância atual do Word.

• O parâmetro Doc do manipulador de eventos para o evento DocumentBeforeSave.O parâmetro Doc é um objeto de Microsoft.Office.Interop.Word.Document, que representa o documento salvo.For more information, see Palavra Overview do modelo de objeto.

Testar o projeto.

Para testar o projeto

1. Pressionarionar F5 para Compilação e execute seu projeto.

   Quando você compila o projeto, o código é compilado em um assembly que acompanha a pasta de saída de compilação para o projeto.O Visual Studio também cria um conjunto de entradas do Registro que permitem o Word para descobrir e carregar o suplemento e ele configura as configurações de segurança no computador de desenvolvimento para habilitar o Adicionar-in executar.For more information, see Office solução Compilação processo Visão geral.

2. No Word, Salvar o documento ativo.

3. Verifique se o seguinte texto é adicionado ao documento.

   Esse texto foi adicionado por meio de código.

4. Word Fechar.

Limpando o projeto

Quando Concluir de desenvolvimento de um projeto, Remover o assembly de Adicionar-in, entradas do Registro e as configurações de segurança do seu computador de desenvolvimento.Caso contrário, o Adicionar-in continuará a executar cada vez que você abrir o Word no seu computador de desenvolvimento.

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

• No Visual Studio, on the menu ComCompilação, clique em Apagar Solução.

Próximas etapas

Agora que você criou um nível de aplicativo Basic Adicionar - in para o Word, você pode saber mais sobre como desenvolver Adicionar-ins destes tópicos:

• Geral tarefas que você pode executar em suplementos de programação: Programação Application-Nível Adicionar-ins.

• Tarefas de programação que são específicas para o Word Adicionar-ins: Desenvolvimento de Adicionar-in de aplicativo-nível do Word.

• Usando o modelo de objeto do Word: Palavra Overview do modelo de objeto.

• Personalizando a interface do usuário do Word, por exemplo, adicionando uma guia personalizada à Faixa de Opções ou criar seu próprio painel de tarefas personalizado: Personalização de IU do Office.

• Criação e Depurando a nível de aplicativo Adicionar-ins para o Word: Criando e Depurando Office Solutions.

• Implantação de aplicativo-nível Adicionar-ins para o Word: Implantar soluções do Office.

Consulte também

Conceitos

Visão geral de desenvolvimento de soluções do Office

Desenvolvimento de Adicionar-in de aplicativo-nível do Word

Programação Application-Nível Adicionar-ins

Palavra Overview do modelo de objeto

Personalização de IU do Office

O Visual Studio Tools for Office Visão geral de modelos do projeto

Referência

Modelos de projeto Adicionar-in do 2003 do Microsoft Office

Modelos de projeto Adicionar-in do 2007 do Microsoft Office

Outros recursos

Criando e Depurando Office Solutions

Implantar soluções do Office

Date	History	Motivo
De 2008 de julho	Tópico adicionado.	Aprimoramento de informações.