Share via

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

  • Artigo

Se você está apenas começando a criar personalizações em nível de 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 Recursos disponíveis por aplicativo e tipo de projeto do Office.

Entender como funcionam as personalizações em nível de documento para o Word

Cada personalização do Word que você cria é 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, mover o cursor para áreas específicas ou clicar em botões e itens de menu, podem chamar métodos de manipulação de eventos no assembly. 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 em nível de documento.

Criar projetos de nível de documento para o Word

Para criar uma personalização em 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 referências de assembly necessárias e arquivos de projeto.

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

Programar documentos do Word usando controles de host de itens de host

Itens de host e controles de host 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, marcadores e nós XML. Os controles de host fornecem funcionalidade semelhante aos objetos nativos do Word, mas também têm novos eventos, suporte a designer e capacidade de vinculaçã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 no código sem precisar navegar no modelo de objeto do Word.

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

Personalizar a interface do usuário do Word

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

Você também pode abrir o documento que está associado ao seu projeto diretamente no Visual Studio. Quando o documento é aberto no Visual Studio, você pode 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 marcadores dessa maneira os vincula 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 Vincular dados a controles em soluções do Office.

Próximas etapas

Para saber como criar uma personalização em nível de documento para o Word, consulte Demonstra Passo a passo: criar sua primeira personalização em nível de 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 em nível de documento do Word.

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

Confira também