Demonstra Passo a passo: Criando seu primeira personalização em nível de documento do Word

Artigo
08/08/2011

Este passo a passo introdutória mostra como criar uma personalização em nível de documento do Word de Microsoft Office. Os recursos que você criar nesse tipo de solução estão disponíveis somente quando um documento específico está aberto. É possível usar uma personalização em nível de documento para fazer alterações em todo o aplicativo, por exemplo, exibindo uma nova guia na faixa de opções quando nenhum documento está aberto.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento 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 documento do Word.
Adicionando texto ao documento que está hospedado no designer de Visual Studio.
Escrevendo código que usa o modelo de objeto do Word para adicionar texto ao documento personalizado quando ele é aberto.
A criação e execução do projeto para testá-lo.
Limpando o projeto para remover arquivos desnecessários de compilação e configurações de segurança do 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 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 projeto de documento do Word no 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 O documento do Word 2007 ou O documento do Word 2010.
No nome , digite FirstDocumentCustomization.
Click OK.

O Visual Studio Tools for Office Project Wizard abre.
Selecione criar um novo documentoe clique em OK.

Visual Studiocria o FirstDocumentCustomization de projeto e, em seguida, adiciona o FirstDocumentCustomization documento e ThisDocument o arquivo de código para o projeto. O FirstDocumentCustomization documento é aberto automaticamente no designer.

Fechar e reabrir o documento no Designer

Se você intencionalmente ou acidentalmente fechar o documento no designer enquanto você estiver desenvolvendo seu projeto, você poderá reabri-lo.

Feche e reabra o documento no designer

Feche o documento clicando o Fechar o botão (X) para a janela de designer.
Em Solution Explorer, com o botão direito do ThisDocument arquivo de código e, em seguida, clique em View Designer.

- or -

Em Solution Explorer, clique duas vezes o ThisDocument o arquivo de código.

Adicionar texto ao documento no Designer

Você pode projetar a interface do usuário (UI) de sua personalização modificando o documento que está aberto no designer. Por exemplo, você pode adicionar texto, tabelas ou controles do Word. Para obter mais informações sobre como usar o designer, consulte Projetos do Office no ambiente de Visual Studio.

Para adicionar texto ao documento usando o designer

No documento que está aberto no designer, digite o texto a seguir.

Este texto foi adicionado usando o designer.

Adicionar texto ao documento programaticamente

Em seguida, adicione o código para o arquivo de código ThisDocument. O novo código usa o modelo de objeto do Word para adicionar um segundo parágrafo do texto no documento. Por padrão, o arquivo de código ThisDocument contém o seguinte código gerado:

Uma definição parcial da ThisDocument classe, que representa o modelo de programação do documento e fornece acesso ao modelo de objeto do Word. For more information, see Item de Host do documento and Palavra Overview do modelo de objeto. O restante do ThisDocument classe é definida em um arquivo de código oculto que você não deve modificar.
O ThisDocument_Startup e ThisDocument_Shutdown manipuladores de evento. Esses manipuladores de eventos são chamados quando o documento é aberto e fechado. Use esses manipuladores de evento para inicializar sua personalização quando o documento é aberto e limpar os recursos usados por sua personalização, quando o documento é fechado. For more information, see Eventos em projetos do Office.

Para adicionar um segundo parágrafo do texto no documento usando código

Em Solution Explorer, com o botão direito ThisDocumente em seguida, clique em Exibir código.

O arquivo de código se abre no Visual Studio.

Substituir o ThisDocument_Startup o manipulador de eventos com o código a seguir. Quando o documento é aberto, este código adiciona um segundo parágrafo do texto no documento.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}

Observação
Esse código usa o valor de índice 1 para acessar o primeiro parágrafo do Paragraphs propriedade. 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.

Testing the Project

Para testar seu documento.

Pressione F5 para criar e executar seu projeto.

Quando você constrói o projeto, o código é compilado em um assembly que está associado ao documento. Visual Studio coloca uma cópia do documento e o assembly na pasta de saída de compilação do projeto e ela configura as configurações de segurança no computador de desenvolvimento para permitir a personalização executar. For more information, see Visão Geral do Processo de Compilação de uma Solução Office.
No documento, verifique se você ver o seguinte texto.

Este texto foi adicionado usando o designer.

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

Limpando o projeto.

Quando terminar de desenvolver um projeto, você deve remover os arquivos na pasta de saída de compilação e as configurações de segurança criadas pelo processo de compilação.

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 uma personalização básica do nível de documento do Word, você pode aprender mais sobre como desenvolver personalizações com estes tópicos:

Tarefas de programação gerais que você pode executar no nível do documento personalizações: Programação personalizações em nível de documento.
Tarefas de programação que são específicas para personalizações em nível de documento 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 criar seu próprio painel de ações: Personalização de interface do usuário do Office.
Usando estendido de objetos do Word fornecidos pela Visual Studio Tools for Office para executar tarefas que não são possíveis usando o modelo de objeto do Word (por exemplo, a hospedagem de controles gerenciados em documentos e controles do Word de ligação a dados usando o modelo de ligação de dados do Windows Forms): Automatizar o Word usando o Extended objetos.
Criação e depuração de personalizações em nível de documento do Word: Criação e depuração de soluções do Office.
Implantando as personalizações em nível de documento do Word: Implantar soluções do Office.