Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Document item hospedeiro é um tipo que estende o Document tipo do assembly de interoperabilidade primário do Word. O Document item de host fornece todas as mesmas propriedades, métodos e eventos como um Document objeto, mas também expõe eventos adicionais e atua como um 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 do VSTO para o Word. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.
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 complemento VSTO, você pode gerar Document itens de host em tempo de execução.
Entender 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 no nível do documento, o Visual Studio gera a ThisDocument classe para servir como o link de comunicação entre o Word e seu código de personalização. A ThisDocument classe fornece acesso aos membros do Document item de 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 associar os controles aos dados, coletar informações do usuário e responder às ações do usuário. Para obter mais informações, consulte Personalizações no nível do 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 Document objeto no assembly de interoperabilidade primário do Word, você também pode usar ThisDocument para acessar o modelo de objeto do Word. Para obter mais informações, consulte a visão geral do modelo de objeto do Word.
Limitações do item host do documento em projetos de nível de documento
Um projeto no nível do documento pode conter apenas um Document item de host (ou seja, a ThisDocument classe). Você não pode adicionar novos Document itens de host ao projeto em tempo de design e não pode criar novos Document itens de host em tempo de execução a partir 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 Document. Como 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.
Entender itens de host de documento em projetos no nível do aplicativo
Em projetos de suplemento do VSTO, você pode gerar um Document item de hospedagem em tempo de execução para qualquer documento 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 host Document, use o método GetVstoObject. Para mais informações, consulte Estender documentos do Word e pastas de trabalho do Excel em complementos VSTO em tempo de execução.