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

  • Artigo

Regiões do formulário personalizado estendem forms padrão ou personalizados do Microsoft Office Outlook.Em essa explicação passo a passo, você criará uma região de formulário personalizado que aparece como uma nova página na janela de inspector de um item contato.Essa região do formulário exibe um mapa de cada endereço que está listado para o contato, envia informações de endereço para o site Local do Windows Live Pesquisa.Para obter informações sobre as regiões do formulário, consulte Criação de regiões de formulário do Outlook.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Outlook 2013 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Essa explicação passo a passo mostra as seguintes tarefas:

  • Criando um novo projeto do suplemento ao Outlook.

  • Adicionando uma região do formulário para o projeto do suplemento.

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

  • Personalizando o comportamento da área do formulário.

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

ObservaçãoObservação

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

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

-

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).
  • Outlook 2013 ou Outlook 2010.

link para vídeo Para uma versão de vídeo de este tópico, consulte Como: exibição Criando uma região de formulário do Outlook.

Criando um novo projeto do suplemento do Outlook

Primeiro criar um projeto básico do suplemento.

Para criar um novo projeto do suplemento do Outlook

  1. Em Visual Studio, crie um projeto do suplemento ao Outlook com o nome MapItAddIn.

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

  3. Salvar o projeto para o diretório.

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

Adicionando uma região do formulário para o projeto do suplemento do Outlook

Uma solução do suplemento ao Outlook pode conter um ou mais itens da área do formulário do Outlook.Adicionar um item da região do formulário ao seu projeto usando o assistente de Novo região de formulário do Outlook .

Para adicionar uma região do formulário para o suplemento do Outlook projeto

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

  2. No menu Project, clique em Add New Item.

  3. Em a caixa de diálogo de Adicionar novo item , Região do Formulário do Outlookselecione, nomeie o arquivo MapIt, e clique em Adicionar.

    O assistente de NovoRegião do Formulário do Outlook .

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

  5. Em a página de Selecione o tipo de região do formulário que você deseja criar , clique em Separado, e clique em Avançar.

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

  6. Em a página de Forneça texto descritivo e selecione suas preferências de exibição , tipo mapear-lo na caixa de Nome .

    Este nome aparece em fita da janela de inspector quando o item de contatos está aberto.

  7. Os inspectores que estão no modo composta Selecione e Inspectores que reagem o modo de leitura, clique em Avançar.

  8. Em a página de Identifica as classes de mensagem que serão exibidos essa região de formulário , Emailclaro, Contatoselecione, e clique em Concluir.

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

Criando o layout da região de formulário

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

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

  1. Em Gerenciador de Soluções, expanda o projeto de MapItAddIn , clique duas vezes em MapIt.cs ou MapIt.vb para abrir o designer da região do formulário.

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

  3. Em a janela de Propriedades , defina Tamanho a 664, 469.

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

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

  5. De a guia de Controles Comuns de Caixa de Ferramentas, adicione Navegador da Web para a área do formulário.

    Navegador da Web Exibirá um mapa de cada endereço que está listado para o contato.

Personalizando o comportamento da área do formulário

Adicione código para manipuladores de eventos da região do formulário para personalizar a maneira que 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 exibir o mapa que constituem a região.Se exibe a área do formulário, o código navega no Windows Live Local Pesquisar e carrega um mapa de cada item listado no endereço de contatos do Outlook.

Para personalizar o comportamento da área do formulário

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

    MapIt.cs ou MapIt.vb abre no editor de códigos.

  2. Expandir a região de código de Constituem a fábrica da região .

    O factory MapItFactory chamado classe da região de formulário é exposta.

  3. Adicione o seguinte código para o manipulador de eventos MapItFactory_FormRegionInitializing.Este manipulador de eventos é quando o usuário abrir um item de contatos.O código a seguir determina se o item de contatos contém um endereço.Se o item de contatos não contém um endereço, os esse código define a propriedade de Cancel da classe de FormRegionInitializingEventArgs a true e para a área do formulário não são exibidos.Caso contrário, o suplemento gera o evento de FormRegionShowing e exibe a área do formulário.

    Private Sub MapItFactory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing

    Dim myItem As Outlook.ContactItem = CType(e.OutlookItem, Outlook.ContactItem)

    If Not (myItem Is Nothing) Then
        If Not (myItem.BusinessAddress Is Nothing) AndAlso myItem.BusinessAddress.Trim().Length > 0 Or (Not (myItem.HomeAddress Is Nothing) AndAlso myItem.HomeAddress.Trim().Length > 0) Or (Not (myItem.OtherAddress Is Nothing) AndAlso myItem.OtherAddress.Trim().Length > 0) Then
            Return
        End If
    End If

    e.Cancel = True

End Sub

    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 para o manipulador de eventos FormRegionShowing.Esse código executa as seguintes tarefas:

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

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

    O site local de Pesquisa aparecerá no mapa área do formulário e apresenta-a cada endereço em risco de preenchimento.

    Private Sub MapIt_FormRegionShowing(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles MyBase.FormRegionShowing
    Dim tempLoc As String = ""
    Dim defaultAddress As String = ""
    Dim scratchPadAddress As String = ""

    Dim myItem As Outlook.ContactItem = _
        CType(Me.OutlookItem, Outlook.ContactItem)

    If Not (myItem Is Nothing) Then
        If Not (myItem.HomeAddress Is Nothing) And _
            myItem.HomeAddress.Trim().Length > 0 Then
            tempLoc = myItem.HomeAddressStreet.Trim() + " " _
                + myItem.HomeAddressCity + " " + myItem.HomeAddressState + _
                    " " + myItem.HomeAddressPostalCode
            If myItem.HomeAddress = myItem.MailingAddress Then
                defaultAddress = tempLoc + "_Home"
            Else
                scratchPadAddress += "adr." + tempLoc + "_Home~"
            End If
        End If
        If Not (myItem.BusinessAddress Is Nothing) And _
            myItem.BusinessAddress.Trim().Length > 0 Then
            tempLoc = myItem.BusinessAddressStreet.Trim() + " " _
                + myItem.BusinessAddressCity + " " + _
                    myItem.BusinessAddressState + " " + _
                        myItem.BusinessAddressPostalCode
            If myItem.BusinessAddress = myItem.MailingAddress Then
                defaultAddress = tempLoc + "_Business"
            Else
                scratchPadAddress += "adr." + tempLoc + "_Business~"
            End If
        End If
        If Not (myItem.OtherAddress Is Nothing) And _
            myItem.OtherAddress.Trim().Length > 0 Then
            tempLoc = myItem.OtherAddressStreet.Trim() + " " + _
                myItem.OtherAddressCity + " " + myItem.OtherAddressState + _
                    " " + myItem.OtherAddressPostalCode
            If myItem.OtherAddress = myItem.MailingAddress Then
                defaultAddress = tempLoc + "_Other"
            Else
                scratchPadAddress += "adr." + tempLoc + "_Other~"
            End If
        End If
    End If

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

End Sub

    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);

}

Testando a região de formulário do Outlook

Quando você executar o projeto, o Visual Studio abre Outlook.Abrir um item de contato para exibir o mapa ele área do formulário.O mapa que região de formulário aparece como uma página na forma de qualquer item de contatos que contém um endereço.

Para testar o mapa ele região de formulário

  1. Pressione F5 para executar o projeto.

    Outlook abre.

  2. Em o Outlook, na guia de Início , clique em Novos Itens, e clique em Contato.

  3. Em o formulário de contatos, o tipo Ann Beebe como o nome de contato, e então especifica os três endereços.

    tipo de endereço

    Endereço

    Business

    St de 4567 canos chave.búfalo, NY

    Home

    St norte 1234.búfalo, NY

    Outros

    St de 3456 canos chave.Seattle, WA

  4. Salve e feche o item contato.

  5. Abra o item de contatos de Ann Beebe .

  6. Em o grupo de Mostrar de fita de item, clique em Mapear para abrir o mapa ele área do formulário.

    O mapa que região de formulário for exibido, e exibe o site local de Pesquisa.Negócios, Início, E endereços de Outro aparecem em risco de preenchimento.Em risco de preenchimento, selecione um endereço que você deseja mapear.

Próximas etapas

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

Consulte também

Tarefas

Passo a passo: Importação de uma região de formulário que é criada no Outlook

Como: adicionar uma região de formulário a um projeto de suplemento do Outlook

Como: impedir a exibição de uma região de formulário do Outlook

Conceitos

Acessando uma região de formulário em tempo de execução

Diretrizes para criação de regiões de formulário do Outlook

A associação de uma região de formulário com uma classe de mensagem do Outlook

Ações personalizadas em regiões de formulário do Outlook

Outros recursos

Criação de regiões de formulário do Outlook