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

Artigo
02/25/2013

Essa explicação passo a passo mostra como criar uma introdução personalização da nível do Microsoft Office Word.Os recursos que você criou em este tipo de solução estão disponíveis somente quando um documento específico está aberto.Você não pode usar uma personalização da nível para fazer as alterações de todo, por exemplo, exibindo uma nova aba de fita quando qualquer documento está aberto.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento 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 documento do word.
Adicionando texto ao documento que é hospedado no designer do Visual Studio.
Escrevendo código que usa o modelo de objeto de palavras para adicionar texto ao documento personalizado quando o é aberto.
Compilação e execução do projeto testá-lo.
Limpando o projeto remover os arquivos e as configurações de segurança desnecessários de compilação 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 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 documento do word 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 Documento do Word 2010 selecione ou de Documento do Word 2013.
Em a caixa de Nome , digite FirstDocumentCustomization.
Clique em OK.

Visual Studio Tools para Office Project Wizard Abre.
Criar um novo documentoSelecione, e clique OK.

Visual Studio criar o projeto de FirstDocumentCustomization , e o arquivo do documento de FirstDocumentCustomization e de código de ThisDocument ao projeto.O documento de FirstDocumentCustomization automaticamente é aberto no designer.

Fechando e reabrindo o documento no designer

Se você fechar deliberadamente ou acidentalmente o documento no designer quando você desenvolver seu projeto, você poderá reabri-lo.

Para fechar e reabrir o documento no designer

Feche o documento clicando no botão de Fechar (X) para a janela de designer.
Em Gerenciador de Soluções, clique com o botão direito do mouse no arquivo de código de ThisDocument , e clique Exibir Designer.

- ou -

Em Gerenciador de Soluções, clique duas vezes no arquivo de código de ThisDocument .

Adicionando texto ao documento no designer

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

Para adicionar texto a seu documento usando o designer

Em o documento que é aberto no designer, digite o seguinte texto.

Esse texto foi adicionado usando o designer.

Adicionando texto ao documento programaticamente

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

Uma definição de classe parcial de ThisDocument , que representa o modelo de programação do documento e fornece acesso ao modelo de objeto de palavras.Para obter mais informações, consulte Item de Host do documento e Visão geral do modelo de objeto do Word.O restante da classe de ThisDocument é definido em um arquivo oculto de código que você não deve alterar.
os manipuladores de eventos de ThisDocument_Startup e de ThisDocument_Shutdown .Esses manipuladores de eventos são chamados quando o documento está aberto e fechado.Use esses manipuladores de eventos para inicializar sua personalização quando o documento está aberto, e para limpar os recursos usados por sua personalização quando o documento é fechado.Para obter mais informações, consulte Eventos em projetos do Office.

Para adicionar um segundo parágrafo de texto ao documento usando código

Em Gerenciador de Soluções, clique com o botão direito do mouse ThisDocument, clique em Exibir Código.

O arquivo de código abre no Visual Studio.

Substitua o manipulador de eventos de ThisDocument_Startup com o código a seguir.Quando o documento está aberto, este código adiciona um novo parágrafo de texto ao 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 na propriedade 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.

Testar o projeto.

para testar seu documento

Pressione F5 para compilar e executar o projeto.

Quando você criar o projeto, o código é compilado em um assembly que está associado com o documento.O Visual Studio coloca uma cópia do documento e assembly na pasta de saída de compilação para o projeto, e configurar as configurações de segurança no computador de desenvolvimento para permitir personalização para executar.Para obter mais informações, consulte Construindo soluções do Office.
Em o documento, verifique que você possa ver o texto a seguir.

Esse texto foi adicionado usando o designer.

Esse texto foi adicionado usando código.
Feche o documento.

limpando o projeto

Quando você 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 no seu computador de desenvolvimento

Em o Visual Studio, no menu de Compilar , clique Limpar solução.

Próximas etapas

Agora que você criou uma personalização básica de um documento nível para palavras, você pode aprender mais sobre como desenvolver personalizações de esses tópicos:

Tarefas básicas de programação que você pode executar personalizações em nível da: Programação personalizações em nível de documento.
Tarefas de programação que são específicas a personalizações de nível para palavra: 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 ações: Personalização de interface do usuário do Office.
Usando objetos estendidos do word fornecidos por soluções do Office no Visual Studio para executar tarefas que não são possíveis usando o modelo de objeto da palavra (por exemplo, hospedando controles gerenciados em documentos e controles do word de associação a dados usando o modelo de associação de dados dos formulários do windows): Automação do Word utilizando o Extended objetos.
Personalizações da nível de compilação e de depuração para palavra: Construindo soluções do Office.
Implantando personalizações de nível para a palavra: Implantando uma solução do Office.