Compartilhar via

Demonstra Passo a passo: Criar uma região de formulário do Outlook

  • Artigo

As regiões de formulário personalizadas estendem formulários padrão ou personalizados do Microsoft Office Outlook. Nesta explicação passo a passo, você criará uma região de formulário personalizada que aparece como uma nova página na janela Inspetor de um item de contato. Essa região do formulário exibe um mapa de cada endereço listado para o contato, enviando as informações de endereço para o site do Windows Live Local Search. Para obter informações sobre regiões de formulário, consulte Criar regiões de formulário do Outlook.

Aplica-se a: As informações neste tópico se aplicam a projetos de suplemento VSTO para Outlook. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Este passo a passo ilustra as seguintes tarefas:

  • Criando um novo projeto de suplemento VSTO do Outlook.

  • Adicionando uma região de formulário ao projeto de suplemento VSTO.

  • Criando o layout da região do formulário.

  • Personalizando o comportamento da região do formulário.

  • Testando a região de formulário do Outlook.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE do Visual Studio.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

link to video Para obter uma versão em vídeo deste tópico, consulte Vídeo como: Criar uma região de formulário do Outlook.

Criar um novo projeto de suplemento VSTO do Outlook

Primeiro, crie um projeto básico de suplemento VSTO.

Para criar um novo projeto de suplemento VSTO do Outlook

  1. No Visual Studio, crie um projeto de suplemento VSTO do Outlook com o nome MapItAddIn.

  2. Na caixa de diálogo Novo Projeto, selecione Criar diretório para solução.

  3. Salve o projeto em qualquer diretório.

    Para obter mais informações, consulte Como: Criar projetos do Office no Visual Studio.

Adicionar uma região de formulário ao projeto de suplemento VSTO do Outlook

Uma solução de suplemento VSTO do Outlook pode conter um ou mais itens de área de formulário do Outlook. Adicione um item de área de formulário ao seu projeto usando o assistente Nova área de formulário do Outlook.

Para adicionar uma região de formulário ao projeto de suplemento VSTO do Outlook

  1. No Gerenciador de Soluções, selecione o projeto MapItAddIn .

  2. No menu Projeto , clique em Adicionar Novo Item.

  3. Na caixa de diálogo Adicionar Novo Item, selecione Região de Formulário do Outlook, nomeie o arquivo MapIt e clique em Adicionar.

    O assistente NewOutlook Form Region é iniciado.

  4. Na página Selecione como você deseja criar a área do formulário, clique em Criar uma nova região do formulário e clique em Avançar.

  5. Na página Selecione o tipo de área de formulário que você deseja criar, clique em Separar e em Avançar.

    Uma área de formulário separada adiciona uma nova página a um formulário do Outlook. Para obter mais informações sobre tipos de área de formulário, consulte Criar regiões de formulário do Outlook.

  6. Na página Fornecer texto descritivo e selecionar suas preferências de exibição, digite Mapeá-lo na caixa Nome.

    Esse nome aparece na Faixa de Opções da janela Inspetor quando o item de contato está aberto.

  7. Selecione Inspetores que estão no modo de composição e Inspetores que estão no modo de leitura e clique em Avançar.

  8. Na página Identificar as classes de mensagem que exibirão esta região de formulário, desmarque Mensagem de Email, selecione Contato e clique em Concluir.

    Um arquivo MapIt.cs ou MapIt.vb é adicionado ao seu projeto.

Criar o layout da região do formulário

Desenvolva regiões de formulário visualmente usando o designer de região de formulário. Você pode arrastar controles gerenciados para a superfície do designer de região do formulário. Use o designer e a janela Propriedades para ajustar o layout e a aparência do controle.

Para criar o layout da região do formulário

  1. No Gerenciador de Soluções, expanda o projeto MapItAddIn e clique duas vezes em MapIt.cs ou MapIt.vb para abrir o Designer de Região de Formulário.

  2. Clique com o botão direito do mouse no designer e clique em Propriedades.

  3. Na janela Propriedades, defina Tamanho como 664, 469.

    Isso garante que a região do formulário seja grande o suficiente para exibir um mapa.

  4. No menu Exibir , clique em Caixa de Ferramentas.

  5. Na guia Controles comuns da caixa de ferramentas, adicione um WebBrowser à região do formulário.

    O WebBrowser exibirá um mapa de cada endereço listado para o contato.

Personalizar o comportamento da região do formulário

Adicione código a manipuladores de eventos de região de formulário para personalizar a maneira como uma região de formulário se comporta em tempo de execução. Para essa região de formulário, o código examina as propriedades de um item do Outlook e determina se a região do formulário Map It deve ser exibida. Se exibir a região do formulário, o código navegará até o Windows Live Local Search e carregará um mapa de cada endereço listado no item de contato do Outlook.

Para personalizar o comportamento da região do formulário

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em MapIt.cs ou MapIt.vb e clique em Exibir Código.

    MapIt.cs ou MapIt.vb é aberto no Editor de Códigos.

  2. Expanda a região de código Fábrica da Região do Formulário.

    A classe de fábrica da região do formulário nomeada MapItFactory é exposta.

  3. Adicione o seguinte código ao manipulador de eventos do MapItFactory_FormRegionInitializing. Esse manipulador de eventos é chamado quando o usuário abre um item de contato. O código a seguir determina se o item de contato contém um endereço. Se o item de contato não contiver um endereço, esse código definirá a CancelFormRegionInitializingEventArgs propriedade da classe como true e a região do formulário não será exibida. Caso contrário, o suplemento VSTO gera o FormRegionShowing evento e exibe a região do formulário.

    private void MapItFactory_FormRegionInitializing(object sender,
    Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
{
    Outlook.ContactItem myItem = (Outlook.ContactItem)e.OutlookItem;

    if (myItem != null)
    {
        if ((myItem.BusinessAddress != null &&
                myItem.BusinessAddress.Trim().Length > 0) ||
            (myItem.HomeAddress != null && 
                myItem.HomeAddress.Trim().Length > 0) ||
            (myItem.OtherAddress != null && 
                myItem.OtherAddress.Trim().Length > 0))
        {
            return;
        }
    }

    e.Cancel = true;
}

  4. Adicione o seguinte código ao manipulador de eventos do FormRegionShowing. Esse código executa as seguintes tarefas:

    • Concatena cada endereço no item de contato e cria uma cadeia de caracteres de URL.

    • Chama o NavigateWebBrowser método do objeto e passa a cadeia de caracteres da URL como um parâmetro.

      O site de Pesquisa Local aparece na região do formulário Map It e apresenta cada endereço no bloco de rascunho.

      private void MapIt_FormRegionShowing(object sender, EventArgs e)
{
    string tempLoc = "";
    string defaultAddress = "";
    string scratchPadAddress = "";

    Outlook.ContactItem myItem = (Outlook.ContactItem)this.OutlookItem;

    if (myItem != null)
    {
        if (myItem.HomeAddress != null && 
                myItem.HomeAddress.Trim().Length > 0)
        {
            tempLoc = myItem.HomeAddressStreet.Trim() + " " + 
                myItem.HomeAddressCity + " " + myItem.HomeAddressState + 
                    " " + myItem.HomeAddressPostalCode;
            if (myItem.HomeAddress == myItem.MailingAddress)
            {
                defaultAddress = tempLoc + "_Home";
            }
            else
            {
                scratchPadAddress += "adr." + tempLoc + "_Home~";
            }
        }
        if (myItem.BusinessAddress != null && 
                myItem.BusinessAddress.Trim().Length > 0)
        {
            tempLoc = myItem.BusinessAddressStreet.Trim() + 
                " " + myItem.BusinessAddressCity + " " + 
                    myItem.BusinessAddressState + " " + 
                        myItem.BusinessAddressPostalCode;
            if (myItem.BusinessAddress == myItem.MailingAddress)
            {
                defaultAddress = tempLoc + "_Business";
            }
            else
            {
                scratchPadAddress += "adr." + tempLoc + "_Business~";
            }
        }
        if (myItem.OtherAddress != null && myItem.OtherAddress.Trim().Length > 0)
        {
            tempLoc = myItem.OtherAddressStreet.Trim() + " " + 
                myItem.OtherAddressCity + " " + myItem.OtherAddressState + 
                    " " + myItem.OtherAddressPostalCode;
            if (myItem.OtherAddress == myItem.MailingAddress)
            {
                defaultAddress = tempLoc + "_Other";
            }
            else
            {
                scratchPadAddress += "adr." + tempLoc + "_Other~";
            }
        }
    }

    webBrowser1.Navigate("http://local.live.com/default.aspx?style=r&where1=" 
        + defaultAddress + "&sp=" + scratchPadAddress);

}

Testar a região de formulário do Outlook

Quando você executa o projeto, o Visual Studio abre o Outlook. Abra um item de contato para exibir a região do formulário Mapeá-lo. A região do formulário Map It aparece como uma página no formato de qualquer item de contato que contenha um endereço.

Para testar a região do formulário Map It

  1. Pressione F5 para executar o projeto.

    O Outlook é aberto.

  2. No Outlook, no separador Base, clique em Novos Itens e, em seguida, clique em Contacto.

  3. No formulário de contato, digite Ann Beebe como o nome do contato e especifique os três endereços a seguir.

    Tipo de Endereço Address
    Negócios 4567 Main St. Buffalo, Nova Iorque
    Início 1234 North St. Buffalo, Nova Iorque
    Outras 3456 Main St. Seattle, WA

  4. Salve e feche o item de contato.

  5. Reabra o item de contato Ann Beebe .

    No Outlook, isso pode ser feito no grupo Localizar abrindo o Catálogo de Endereços para Contatos ou digitando Ann Beebe em Pesquisar Pessoas.

  6. No grupo Mostrar da Faixa de Opções do item, clique em Mapeá-lo para abrir a região do formulário Mapeá-lo.

    A região do formulário Map It é exibida e exibe o site de Pesquisa Local. Os endereços Comercial, Casa e Outros aparecem no bloco de rascunho. No bloco de rascunho, selecione um endereço que você deseja mapear.

Próximas etapas

Você pode saber mais sobre como personalizar a interface do usuário de um aplicativo do Outlook a partir destes tópicos:

Conteúdo relacionado