Item de Host do documento

Artigo
08/08/2011

O Document item de host é um tipo que estende o Microsoft.Office.Interop.Word.Document o tipo do assembly de interoperabilidade primária para o Word. O Document o item de host fornece todas as mesmas propriedades, métodos e eventos como um Microsoft.Office.Interop.Word.Document o objeto, mas ele também expõe eventos adicionais e atua como um recipiente para controles de host e controles do Windows Forms.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Em projetos de nível de documento, é um padrão Document item de host, que representa o documento no seu projeto. Em projetos de nível de aplicativo, você pode gerar Document itens do host em tempo de execução.

Noções básicas sobre o Item de Host do documento em projetos de nível de documento

Para acessar o documento em seu projeto, use o ThisDocument classe. Quando você cria um projeto de nível de documento, Visual Studio gera a ThisDocument classe para servir como o link de comunicação entre o Word e o código de personalização. O ThisDocument classe fornece acesso a membros da Document o item de host para executar tarefas básicas de personalização, como a execução de código quando o documento é aberto ou fechado. Você também pode usar a classe para adicionar controles e as marcas inteligentes no documento. Combinando a diferentes conjuntos de controles e escrevendo o código, que você pode vincular controles a dados, coletar informações do usuário e responder a ações do usuário. For more information, see Programação personalizações em nível de documento.

Observação
As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

O ThisDocument classe fornece um local no qual você pode começar a escrever código em seu projeto. Porque a classe fornece todas as mesmas propriedades, métodos e eventos como a Microsoft.Office.Interop.Word.Document de objeto no assembly de interoperabilidade primária para o Word, você também pode usar ThisDocument para acessar o modelo de objeto do Word. For more information, see Palavra Overview do modelo de objeto.

Limitações do Item de Host do documento em projetos de nível de documento

Um projeto de nível de documento pode conter apenas um Document o item de host (isto é, o ThisDocument classe). Você não pode adicionar novas Document itens do host ao seu projeto no tempo de design e você não podem criar novos Document itens do host em tempo de execução de uma personalização no nível do documento.

Se você criar um novo documento do Word em tempo de execução, ele será do tipo Microsoft.Office.Interop.Word.Document. Porque ele não é um item de host, ele não pode conter quaisquer controles de host ou controles Windows Forms. Para obter mais informações sobre a criação de documentos em tempo de execução, consulte Como: Criar novos documentos.

Noções básicas sobre os itens de Host de documentos em projetos de nível de aplicativo

Em projetos de nível de aplicativo, você pode gerar um Document o item de host em tempo de execução para qualquer documento que está aberto no Word. Você pode usar o Document o item de host para adicionar controles e marcas inteligentes para o documento associado, ou para manipular eventos que não estão disponíveis em Microsoft.Office.Interop.Word.Document objetos.

Para gerar um Document item de host, use o GetVstoObject método. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.