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

  • Artigo

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

  • Microsoft Office Sistema de 2007

  • Microsoft Office 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Quando você estende o Microsoft Office Word ou Microsoft Office Excel usando uma personalização de nível de documento, você pode executar as seguintes tarefas:

  • Automatizar o aplicativo Microsoft Office usando o modelo de objeto do aplicativo.

  • Adicionar controles para a superfície do documento.

  • Chame Visual Basic para código Applications (VBA) no documento do assembly de personalização.

  • Chamar o código no assembly de personalização do VBA.

  • Gerenciar determinados aspectos do documento enquanto estiver em um servidor que não tenha o Microsoft Office instalado.

  • Personalizar a interface de usuário (UI) do aplicativo.

Para Geral informações sobre personalizações em nível de documento e outros tipos de soluções que você pode criar usando Ferramentas do Visual Studio para o Office, consulte Visão geral de desenvolvimento de soluções do Office.

Escrevendo código em projetos de nível de documento

Quando você cria um projeto de nível de documento, Ferramentas do Visual Studio para o Office gera automaticamente uma classe no projeto que você pode usar para Iniciar escrever seu código.Ferramentas do Visual Studio para o Office gera classes diferentes para o Word e Excel:

  • Em projetos de nível de documento do Word, a classe é chamada ThisDocument por padrão.

  • Projetos de nível de documento para o Excel ter Múltiplo gerado classes: uma para a pasta de trabalho propriamente dito e outra para cada planilha.Por padrão, essas classes têm os seguintes nomes:

    • ThisWorkbook

    • Sheet1

    • Sheet2

    • Sheet3

A classe gerada inclui manipuladores de eventos que são chamados quando o documento é aberto ou Fechada.Para executar código quando o documento é aberto, Adicionar código ao manipulador de eventos Startup.Para executar código somente antes de fechar o documento, Adicionar código ao manipulador de eventos Shutdown.For more information, see O Visual Studio Tools for Office Projeto eventos.

Cada uma das classes geradas automaticamente em um projeto de nível de documento deriva uma classe de Ferramentas do Visual Studio para o Office chamada de item de host um .Por exemplo, a classe ThisDocument no Word projeto deriva o item de host Microsoft.Office.Tools.Word.Document.For more information, see Itens de host e Visão geral sobre controles de host.

Acessando o modelo de objeto do aplicativo host

Para acessar o modelo de objeto do aplicativo host, use membros da classe gerada em seu projeto.Cada uma dessas classes corresponde a uma classe no modelo de objeto do Excel ou Word e eles contêm a maioria das mesmas propriedades, métodos e eventos.Por exemplo, a classe de ThisDocument em um projeto em nível de documento para o Word fornece a maioria dos mesmos membros como a classe Microsoft.Office.Interop.Word.Document no modelo de objeto do Word.

O exemplo de código a seguir mostra como usar o modelo de objeto do Word para salvar o documento que faz parte de uma personalização de nível de documento do Word.Este exemplo destina-se a ser executado a partir da classe ThisDocument.

Me.Save()

this.Save();

Para fazer a mesma coisa de fora a classe de ThisDocument , use o objeto Globals para acessar a classe ThisDocument.Para obter mais informações sobre o objeto de Globals , consulte Global Acessar a objetos no Visual Studio Tools para projetos do Office.

Por exemplo, você pode adicionar esse código para um arquivo de código do painel de ações se você quiser incluir um Salvar botão no painel de ações da interface do usuário.

Globals.ThisDocument.Save()

Globals.ThisDocument.Save();

Porque a classe ThisDocument deriva de item de host Microsoft.Office.Tools.Word.Document , o método de Save é chamado nesse código é, na verdade, o método Save do item de host Microsoft.Office.Tools.Word.Document.Esse método corresponde ao método Save de classe Microsoft.Office.Interop.Word.Document no modelo de objeto do Word.

Para obter mais informações sobre como usar os modelos de objeto do Word e do Excel, consulte Palavra Overview do modelo de objeto e Visão geral do modelo de objeto do Excel.

Adicionar controles a documentos

Para personalizar a interface do usuário do documento, você pode adicionar controles de Windows Forms ou host controles para a superfície do documento.Ao combinar diferentes conjuntos de controles e escrevendo código, que você pode Ligar controles a dados, coletar informações do usuário e responder às ações do usuário.

Controles de host são classes que se estendem alguns dos objetos no modelo de objeto do Word e Excel.Por exemplo, o Controlarar de host Microsoft.Office.Tools.Excel.ListObject fornece Tudo da funcionalidade do Microsoft.Office.Interop.Excel.ListObject no Excel.No entanto, o Controlarar de host Microsoft.Office.Tools.Excel.ListObject também possui outros eventos e recursos de ligação de dados.

Para obter mais informações, consulte Itens de host e Visão geral sobre controles de host e Controles de formulários do Windows em Visão geral de documentos do Office.

Combinação de VBA e personalizações de nível de documento

Você pode usar código do VBA em um documento que faz parte de uma personalização de nível de documento Ferramentas do Visual Studio para o Office.Em todos os projetos de nível de documento, você pode chamar código do VBA no documento do conjunto de módulos (assembly) de personalização.Em projetos de nível de documento para o 2007 Microsoft Office Sistema, você também pode configurar seu projeto para habilitar código VBA do documento para chamar o código no assembly de personalização.

For more information, see Combinação de VBA e personalizações de nível de documento.

Gerenciando documentos em um servidor

Você pode gerenciar vários diferentes aspectos de personalizações em nível de documento em um servidor que não tenha o Microsoft Office Word ou o Microsoft Office Excel instalado.Por exemplo, você pode acessar e modificar dados em que o cache de dados do documento.Você também pode gerenciar o assembly de personalização de Ferramentas do Visual Studio para o Office associado com o documento.Por exemplo, você programaticamente pode remover o conjunto do documento para que o documento não executa o código, ou você pode anexar programaticamente um assembly a um documento.

For more information, see Gerenciando documentos em um servidor usando a classe do ServerDocument.

Personalizando a interface do usuário de aplicativos do Microsoft Office

Você pode personalizar a interface do usuário do Word e Excel usando uma personalização de nível de documento.

Ambos versões 2003 e 2007 do Microsoft Office

Para Microsoft Office 2003 e o 2007 Microsoft Office Sistema, você pode personalizar a interface do usuário das seguintes maneiras:

O versão 2007

Para Word 2007 e Excel 2007, você também pode personalizar a interface do usuário das seguintes maneiras:

O versão 2003

Para Word 2003 e Excel 2003, você também pode personalizar a interface do usuário das seguintes maneiras:

Para obter mais informações sobre como personalizar os aplicativos da interface do usuário do Microsoft Office, consulte Personalização de IU do Office.

Consulte também

Tarefas

Como: Criar e modificar propriedades Personalizars de documentos

Como: Ler e gravar em propriedades do documento

Conceitos

Combinação de VBA e personalizações de nível de documento

Gerenciando documentos em um servidor usando a classe do ServerDocument

Obtendo estendido objetos de objetos do Office nativo em personalizações de nível de documento

Outros recursos

Controles em documentos do Office