Demonstra Passo a passo: Criando seu Primeiro personalização em nível de documento para 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 documento

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 a você como criar uma personalização de nível de documento do Microsoft Office Word.Os recursos que você criar nesse tipo de solução estão disponíveis somente quando um documento específico é Abrir.Você não pode usar uma personalização de nível de documento para fazer alterações todo o aplicativo, por exemplo, exibindo uma Novo guia da Faixa de Opções quando nenhum documento está Abrir.

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

  • Criando um projeto de documento do Word para Word 2003 ou no Word 2007.

  • Adicionar texto ao documento que está hospedado no designer do Visual Studio.

  • Escrever código que usa o modelo de objeto do Word para adicionar texto ao documento personalizado quando ele for aberto.

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

  • Limpando o projeto para remover arquivos desnecessários de compilação e configurações de segurança do computador 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 um novo projeto de documento do Word 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 2007 se você estiver desenvolvendo uma personalização do Word 2007, ou Selecionar a pasta de 2003 se você estiver desenvolvendo uma personalização do Word 2003.

    Observação:

    Se você estiver desenvolvendo uma personalização de nível de documento para uma versão específica do Word, essa versão deve ser instalada no seu computador de desenvolvimento.

  5. No painel Modelos , Selecionar de documento do Word 2003 ou Documento do Word 2007.

  6. Na caixa Nome, tipo FirstDocumentCustomization.

  7. Clique em OK.

    Abre o Visual Studio Tools para Office Projeto Assistente.

  8. Selecionar Criar um documento novoe clique em OK.

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

Fechar e reabrir o documento no Designer

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

Para fechar e reabrir o documento no designer

  1. Feche o documento clicando no botão de fechar (X) para a janela de designer.

  2. Em Gerenciador de Soluções, clique com o botão direito do mouse o arquivo de código ThisDocument e clique em Exibir Designer.

    - ou -

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

Adicionando texto ao documento no Designer

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

Para adicionar texto a seu documento usando o designer

  • No documento que é Abrir no designer, digite o seguinte texto.

    Esse texto foi adicionado usando o designer.

Adicionar texto ao documento por programação

Avançar, Adicionar 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 de texto ao documento.Por padrão, o arquivo de código ThisDocument contém o seguinte código gerado:

  • Uma definição parcial da classe ThisDocument, que representa o modelo de programação do documento e fornece Acessar ao modelo de objeto do Word.Para obter mais informações, consulte Item de host do documento e Palavra Overview do modelo de objeto.O restante da classe ThisDocument é definido em um arquivo de código oculto que você não deve modificar.

  • O ThisDocument_Startup e ThisDocument_Shutdown manipuladores de eventos.Esses manipuladores de eventos são chamados quando o documento é aberto e Fechada.Use esses manipuladores de eventos ao inicializar sua personalização quando o documento é aberto e para Apagar recursos utilizados pela sua personalização quando o documento é Fechada.For more information, see O Visual Studio Tools for Office Projeto eventos.

Para adicionar um segundo parágrafo do texto ao documento por meio de código

  1. Em Gerenciador de Soluções, clique com o botão direito do mouse ThisDocumente clique em Exibir Code.

    O arquivo de código é aberto no Visual Studio.

  2. Substituir o manipulador de eventos de ThisDocument_Startup com o código a seguir.Quando o documento é aberto, este código adiciona um segundo 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:

    Este código usa o valor de índice 1 para acessar o primeiro parágrafo a Propriedade 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#.

Testar o projeto.

Para testar seu documento

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

    Quando você Compilação o projeto, o código é compilado em um assembly associado com o documento.O Visual Studio coloca uma Copiar do documento e o assembly na pasta de saída de compilação para o projeto e ele configura as configurações de segurança no computador de desenvolvimento para ativar a personalização ser executado.For more information, see Office solução Compilação processo Visão geral.

  2. No documento, verifique se você ver o seguinte texto.

    Esse texto foi adicionado usando o designer.

    Esse texto foi adicionado por meio de código.

  3. Fechar o documento.

Limpando o projeto

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

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 Basic personalização de nível de documento do Word, você pode saber mais sobre como desenvolver as personalizações destes tópicos:

Consulte também

Conceitos

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

Desenvolvimento de personalização de nível de documento do Word

Personalizações de nível de documento de programação

Palavra Overview do modelo de objeto

Automatizar o Word usando estendido objetos

Personalização de IU do Office

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

Referência

Modelo de projeto de documento do Word

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.