Introdução à programação de personalizações no nível do documento para o Word

Se você estiver apenas começando a criar personalizações no nível do documento para o Microsoft Office Word usando o Visual Studio, aqui está o que você precisa saber.

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

Entender como funcionam as personalizações no nível do documento para o Word

Cada personalização do Word criada é baseada em um único documento. Para começar a usar a personalização, o usuário final abre o documento ou cria o documento a partir de um modelo do Word. Eventos no documento, por exemplo, ao movimentar o cursor para áreas específicas ou clicar em botões e itens de menu, podem chamar métodos de tratamento de eventos na montagem. Quando o documento é fechado, os recursos fornecidos pela personalização não estão mais disponíveis no Word.

Para obter mais informações, consulte Arquitetura de personalizações no nível do documento.

Criar projetos no nível do documento para o Word

Para criar uma personalização de nível de documento para o Word, use o modelo de projeto Documento do Word ou Modelo do Word na caixa de diálogo Novo Projeto. Esses modelos incluem as referências necessárias de assemblies e os arquivos de projeto.

Para obter mais informações sobre como criar um projeto no nível do documento para o Word, consulte Como criar projetos do Office no Visual Studio. Para obter mais informações sobre os modelos de projeto, consulte a visão geral dos modelos de projeto do Office.

Programar documentos do Word usando controles de host de itens.

Itens de hospedeiro e controles de hospedeiro são classes que fornecem o modelo de programação para personalizações em nível de documento.

Os itens de host fornecem um ponto de entrada para seu código e também podem atuar como contêineres para controles de host e controles do Windows Forms. Em projetos de nível de documento para o Word, o item de host é representado pela ThisDocument classe.

Os controles de host são baseados em objetos nativos do Word, como controles de conteúdo, indicadores e nós XML. Os controles de host fornecem funcionalidade semelhante aos objetos nativos do Word, mas também têm novos eventos, suporte ao designer e funcionalidade de associação de dados. Eles aparecem como objetos de primeira classe no código do projeto e no IntelliSense, o que facilita a referência a objetos específicos diretamente em seu código sem precisar navegar pelo modelo de objeto do Word.

Para obter mais informações, consulte os seguintes tópicos:

• Programar personalizações no nível do documento

• Automatizar o Word usando objetos estendidos

• Visão geral de itens de host e controles de host

Personalizar a interface do usuário do Word

A maioria das soluções do Microsoft Office modifica a interface do usuário do aplicativo do Office para fornecer alguma maneira de os usuários interagirem com a solução. Há muitas maneiras pelas quais você pode modificar a interface do usuário do Word usando uma personalização no nível do documento. Por exemplo, você pode adicionar controles à faixa de opções e exibir um painel de ações. Para obter mais informações, consulte a personalização da interface do usuário do Office.

Você também pode abrir o documento associado ao projeto diretamente no Visual Studio. Quando o documento estiver aberto no Visual Studio, você poderá modificar o documento usando a interface do usuário do Word. Você também pode usar o documento como uma superfície de design, o que permite arrastar controles para ele. Para obter mais informações, consulte projetos do Office no ambiente do Visual Studio.

Associar controles a dados

Os controles de conteúdo e o Bookmark controle estão na lista de controles que você pode arrastar da janela Fontes de Dados . Adicionar controles de conteúdo e indicadores dessa forma os associa automaticamente à fonte de dados que você configurou usando a janela. Sem escrever nenhum código, você pode exibir dados de bancos de dados, serviços e objetos de negócios. Para obter mais informações, consulte Associar dados a controles em soluções do Office.

Próximas etapas

Para saber como criar uma personalização no nível do documento para o Word, confira Passo a passo: criar sua primeira personalização no nível do documento para o Word. Este passo a passo apresenta as ferramentas de desenvolvimento do Office no Visual Studio e o modelo de programação para personalizações no nível de documento do Word.

Para obter uma lista de tópicos que orientam você em algumas das tarefas comuns em projetos do Word, consulte tarefas comuns na programação do Office.

Consulte também

• Como criar projetos do Office no Visual Studio
• Programar personalizações no nível do documento
• Soluções do Word
• Passo a passo: criar sua primeira personalização no nível do documento para o Word
• Instruções passo a passo usando o Word
• Visão geral do modelo de objeto do Word
• Escrever código em soluções do Office