Item de host do documento
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. Projetos de nível de documento
Projetos de nível de aplicativo
For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto. |
O item de host Document representa um documento do Word que expõe eventos e atua como um Contêiner para controles de host e os controles Windows Forms.O item de host Document também fornece Tudo as mesmas propriedades, méTudos e eventos como a classe Microsoft.Office.Interop.Word.Document no assembly de interoperabilidade primária do Word.
Em projetos de nível de documento, não existe é um item de host Document que representa o documento em seu projeto.Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), você também pode gerar Document host itens em tempo de execução usando o nível de aplicativo Adicionar-ins para Word 2007.
Noções básicas sobre o item de host do documento em projetos de nível de documento
Para programaticamente acessar o documento em seu projeto, use a classe ThisDocument.Quando você Criar um projeto de nível de documento, Ferramentas do Visual Studio para o Office gera a classe de ThisDocument para servir como o link de comunicação entre o Word e o código de personalização. A classe ThisDocument deriva da classe de item de host Document . Ferramentas do Visual Studio para o Office automaticamente instancia a classe ThisDocument para você quando o documento é aberto em tempo de execução. Você não deve tentar instanciar a classe Document diretamente em seu código.
A classe ThisDocument fornece Acessar a membros do item de host Document Executando Basic tarefas em sua personalização, como Executando código quando o documento é aberto ou Fechada.Você também pode usar a classe para adicionar controles e as marcas inteligentes ao 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.For more information, see Personalizações de nível de documento de programação.
A classe ThisDocument fornece um local no qual você pode iniciar escrever código em seu projeto.Como a classe fornece Tudo as mesmas propriedades, méTudos e eventos como a classe Microsoft.Office.Interop.Word.Document 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
Um projeto de nível de documento pode conter somente um item de host Document.Você não pode adicionar novos itens de host Document a seu projeto em tempo de design, e você através de programação não é possível criar itens de host de novo Document em tempo de execução de uma personalização de nível de documento.
Se você criar um novo documento do Word em tempo de execução, será do tipo de Microsoft.Office.Interop.Word.Document.Porque não é um item de host, não pode conter os controles de host ou controles de Windows Forms.Para obter mais informações sobre a criação de documentos em tempo de execução, consulte Como: Criar novo documento.
Noções básicas sobre itens de host do documento em projetos de nível de aplicativo
Iniciando no SP1, você pode gerar um item de host Document em tempo de execução para qualquer documento que está Abrir no Word.Você pode usar o item de host Document para adicionar controles e as marcas inteligentes para o documento associado.
Para gerar um item de host Document , use o método GetVstoObject de qualquer objeto Microsoft.Office.Interop.Word.Document.For more information, see Estendendo os documentos do Word e Excel pastas de trabalho no nível de aplicativo Adicionar-ins em tempo de execução.
Consulte também
Conceitos
Itens de host e Visão geral sobre controles de host
Palavra Overview do modelo de objeto
Limitações através de programação de itens de host e controles de host
Outros recursos
Date |
History |
Motivo |
|---|---|---|
De 2008 de julho |
Informações sobre usar Document host itens em projetos de nível de aplicativo Adicionados. |
Alteração de recurso do SP1. |