Item de Host do documento

Artigo
02/25/2013

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

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 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

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

Entendendo o item host do documento em projetos de um documento Nível

para acessar o documento em seu projeto, use a classe de ThisDocument .Quando você cria um projeto de um documento nível, o Visual Studio gera a classe de ThisDocument para servir como o link da palavra e comunicação entre o seu código de personalização.A classe de ThisDocument fornece acesso a membros de item host de Document para executar tarefas básicas da sua personalização, como o código de execução quando o documento está aberto ou fechada.Você também pode usar a classe para adicionar controles ao documento.Combinando diferentes conjuntos de controles e escrevendo código, você pode associar controles a dados, colete informações do usuário, e responder às ações do usuário.Para obter mais informações, consulte Programação personalizações em nível de documento.

A classe de ThisDocument fornece um local em que você pode começar a escrever código em seu projeto.Porque a classe fornece todas as mesmas propriedades, métodos, eventos e que o objeto de Microsoft.Office.Interop.Word.Document no assembly de interoperabilidade primária para palavras, você também pode usar ThisDocument para acessar o modelo de objeto de palavras.Para obter mais informações, consulte Visão geral do modelo de objeto do Word.

Limitações de item de host do documento em projetos de um documento Nível

Um projeto de um documento nível pode conter somente um item de host de Document (ou seja, a classe de ThisDocument ).Você não pode adicionar novos itens de host de Document ao seu projeto em tempo de design, e você não pode criar novos itens de host de Document em tempo de execução de uma personalização da nível.

Se você criar um novo documento do word em tempo de execução, será de tipo Microsoft.Office.Interop.Word.Document.Porque não é um item host, não pode conter os controles host ou controles de formulários do windows.Para obter mais informações sobre como criar documentos em tempo de execução, consulte Como criar novos documentos programaticamente.

Itens entendendo de host documento em projetos de Nível de aplicativo

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

Para gerar um item de host de Document , use o método de GetVstoObject .Para obter mais informações, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.