Item de host do documento
O Document item de host é um tipo que estende o Document tipo do assembly de interoperabilidade primário para o Word. O Document item de host fornece todas as mesmas propriedades, métodos e eventos como um objeto, mas também expõe eventos adicionais e atua como um Document contêiner para controles de host e controles do Windows Forms.
Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.
Em projetos de nível de documento, há um item de host padrão Document que representa o documento em seu projeto. Em projetos de suplemento VSTO, você pode gerar Document itens de host em tempo de execução.
Compreender o item de host do documento em projetos de nível de documento
Para acessar o documento em seu projeto, use a ThisDocument classe. Quando você cria um projeto de nível de documento, o Visual Studio gera a classe para servir como o link de comunicação entre o ThisDocument Word e seu código de personalização. A ThisDocument classe fornece acesso a membros do item de Document host para executar tarefas básicas em sua personalização, como executar código quando o documento é aberto ou fechado. Você também pode usar a classe para adicionar controles ao documento. Combinando diferentes conjuntos de controles e escrevendo código, você pode vincular os controles a dados, coletar informações do usuário e responder a ações do usuário. Para obter mais informações, consulte Personalizações em nível de documento do programa.
A ThisDocument classe fornece um local no qual você pode começar a escrever código em seu projeto. Como a classe fornece todas as mesmas propriedades, métodos e eventos que o objeto no assembly de interoperabilidade primário do Word, você também pode usar ThisDocument para acessar o Document modelo de objeto do Word. Para obter mais informações, consulte Visão geral do modelo de objeto do Word.
Limitações do item de host de documento em projetos de nível de documento
Um projeto em nível de documento pode conter apenas um Document item de host (ou seja, a ThisDocument classe). Não é possível adicionar novos itens de host ao projeto em tempo de design e não é possível criar novos Document Document itens de host em tempo de execução a partir de uma personalização em nível de documento.
Se você criar um novo documento do Word em tempo de execução, ele será do tipo Document. Como ele não é um item de host, ele não pode conter controles de host ou controles do Windows Forms. Para obter mais informações sobre como criar documentos em tempo de execução, consulte Como: Criar novos documentos programaticamente.
Compreender itens de host de documento em projetos de nível de aplicativo
Em projetos de suplemento VSTO, você pode gerar um item de Document host em tempo de execução para qualquer documento que esteja aberto no Word. Você pode usar o item de Document host para adicionar controles ao documento associado ou para manipular eventos que não estão disponíveis em Document objetos.
Para gerar um item de Document host, use o GetVstoObject método. Para obter mais informações, consulte Estender documentos do Word e pastas de trabalho do Excel em suplementos VSTO em tempo de execução.