VSTO

Este tutorial mostra como criar um suplemento VSTO e incorporar o DotNetBrowser no Microsoft Outlook.

O DotNetBrowser fornece um controle WinForms BrowserView que pode ser utilizado com suplementos VSTO para adicionar o navegador baseado no Chromium como parte integrante de uma aplicação Microsoft Office. Neste tutorial, mostraremos como incorporar um controle BrowserView no inspetor do Microsoft Outlook.

Implementação

Adicionando o DotNetBrowser ao projeto Add-in

No Visual Studio, crie um projeto de suplemento de amostra para o Microsoft Outlook. Você pode encontrar o modelo de projeto correspondente na seção “VSTO Add-ins”:

Adicione todas as referências necessárias ao nosso projeto. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Referências e selecione Adicionar Referência…:

Selecione todos as montagens DotNetBrowser necessárias e clique em Adicionar:

Certifique-se de que a licença do DotNetBrowser também esteja configurada conforme descrito neste artigo.

Para tornar a depuração do suplemento mais conveniente, configure o registro do DotNetBrowser durante a inicialização do suplemento e especifique a localização para armazenar o arquivo de registro, conforme mostrado abaixo:

Criando região do formulário

Adicionar uma região de formulário que é utilizada para substituir ou personalizar os formulários padrão do Outlook. Para o fazer, clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Adicionar Novo Item:

Especifique como a região do formulário do Outlook é criada. Para fazer isso, selecione a opção Criar uma nova região de formulário e clique em Próximo.

Selecione o tipo de região do formulário. Neste tutorial, criamos esta região do formulário como uma página separada no formulário.

Escreva o nome da região de formulário e selecione os tipos de inspetor em que esta região de formulário aparece e clique em Próximo.

Selecione as classes de mensagens para especificar os tipos de itens do Outlook para os quais a região do formulário deve estar disponível e clique em Finalizar. Por exemplo, selecionando IPM.Note torna a região do formulário disponível para as mensagens de correio eletrônico.

Adicionando o controle BrowserView à Caixa de Ferramentas

Após a criação da região de formulário, o designer da região de formulário se abre. Para o tornar mais conveniente, adicione o controle BrowserView à do Caixa de Ferramentas do Visual Studio. Existem algumas formas de o fazer e a mais simples é adicioná-lo manualmente a partir da montagem. Para isso, clique com o botão direito do mouse na Caixa de Ferramentas e selecione Escolher Items…:

Aparece a caixa de diálogo Selecionar Itens da Caixa de Ferramentas. Clique no botão Navegar para adicionar o controle BrowserView à lista:

No seletor de arquivos, selecione a montagem DotNetBrowser.WinForms que contém o controle BrowserView:

Certifique-se de que o controle BrowserView está agora listado e selecionado e clique em OK.

O controle BrowserView aparece na Caixa de Ferramentas do Visual Studio:

Adicionando o BrowserView à região do formulário

Adicione o controle BrowserView à região do formulário a partir da Caixa de Ferramentas e ajuste a respectiva disposição. Por exemplo, você pode especificar a sua propriedade Dock como Fill para preencher toda a região do formulário com o controle:

Crie uma instância IBrowser e inicialize o BrowserView antes de a região ser apresentada.

Construindo e executando o projeto

Crie e execute o projeto para iniciar o Microsoft Outlook com o suplemento de amostra configurado. Na janela do Outlook, clique no botão Novo Email.

O formulário do Microsoft Outlook é apresentado. No friso do formulário, você pode ver o botão BrowserFormRegion.

Clique no botão BrowserFormRegion, para apresentar a região do formulário de amostra com o BrowserView incorporado.