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

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Versão do Microsoft Office Outlook 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Regiões de formulário Personalizar estendem formulários do Microsoft Office Outlook 2007 padrão ou Personalizars.Nesta explicação passo a passo, você irá Design uma região de formulário Personalizar que aparece como uma Novo página na janela de inspetor de um item de contato.Essa região de formulário exibe um mapa de cada endereço listado para o contato, enviando as informações de endereço para o Windows Live Pesquisar site local.

Para obter informações sobre regiões de formulário, consulte Criar regiões de formulário do Outlook.

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

• Criar um novo Outlook Adicionar no projeto.

• Adicionar uma região de formulário ao projeto add-in.

• Criar o layout da região de formulário.

• Personalizar o comportamento da região de formulário.

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

Observação:
Seu computador pode mostrar diferentes nomes ou localizações 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, consulte Configurações do Visual Studio.

Pré-requisitos

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

• Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

• Microsoft Office Outlook 2007.

• Uma conexão com a Internet para usar o serviço de Pesquisarr local.

Criar um novo Outlook Adicionar - projeto

Primeiro crie um Basic Adicionar no projeto.

Para criar um novo Outlook Adicionar - projeto

1. Em Visual Studio, Criar um projeto de suplemento do Outlook 2007 com o nome MapItAddIn.

2. Na caixa de diálogo de Do novo projeto de , Selecionar Criar Diretório for solução.

3. Salvar o projeto para qualquer Diretório.

   For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

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

Um Outlook Adicionar - solução pode conter uma ou mais Outlook formulário itens de região.Adicionar um item de região de formulário ao seu projeto, usando o Assistente de Novo região de formulário do Outlook.

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

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

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

3. No Adicionar Novo Item caixa de diálogo, Selecionar De região de formulário do Outlook, nomeie o arquivo MapIt e, em seguida, clique em Adicionar.

   The NewOutlook Form Regionwizard starts.

4. No Selecionar como você deseja criar a página de de região de formulário, clique em Design um novo de região de formulárioe, em seguida, clique em Avançar.

5. No Selecionar o tipo da região de formulário que você deseja criar página de , clique separado de e, em seguida, clique em Avançar de .

   Adiciona uma região de formulário separado um Novo Página a um formulário do Outlook.Para obter mais informações sobre tipos de região de formulário, consulte Criar regiões de formulário do Outlook.

6. No Fornecer texto descritivo e Selecionar sua página preferências de Exibir, tipo mapa- na caixa de nome.

   Esse nome aparece nFaixa de Opções de Opções da janela do inspetor quando o item de contato Abrir.

7. Selecionar Inspectors que estão em Redigir modo e Inspectors que são na leitura de modoe clique em Avançar de .

8. Em Identificar a mensagem de classes que será Exibir nesta página de da região de formulário, desmarque Email, Selecionar Contatoe clique em Concluir.

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

Criando o layout da área de formulário

Desenvolver regiões de formulário visualmente, usando o formulário região designer.Você pode arrastar controles gerenciados para a Superfície do Designerer de região de formulário.Use o designer e a janela de propriedades para ajustar o layout do Controlarar e a aparência.

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

1. Em Gerenciador de Soluções, Expandirir o projeto de MapItAddIn e clique Duplo 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 o designer e clique em Propriedades.

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

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

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

5. Na guia Controles ComumComumum da caixa de ferramentas **,**Adicionar Comumum Navegador da Web para a região de formulário.

   Navegador da Web exibirá um mapa de cada endereço é listado para o contato.

Personalizar o comportamento da área de formulário

Adicionar código para manipuladores de eventos de região de formulário para personalizar a maneira uma região de formulário se comporta em tempo de execução.Para esta região de formulário, o código examina as propriedades de um item do Outlook e determina se exibir a região de formulário mapa-lo.Se ele exibe a região de formulário, o código navega para o Windows Live Pesquisar local e carrega um mapa de cada endereço listado no item de contato do Outlook.

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

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

   MapIt.cs ou MapIt.vb abre no Editor de código.

2. Expandirir a região de código de fábrica de região de formulário.

   A classe de fábrica de região de formulário chamada MapItFactory é exposta.

3. Adicione o seguinte código para o manipulador de eventos MapItFactory_FormRegionInitializing.Esse manipulador de evento é 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 define a propriedade de Cancel da classe FormRegionInitializingEventArgs como true e a região de formulário não será exibida.Caso contrário, o Adicionar - em dispara o evento FormRegionShowing e exibe a região de 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 endereço no item de contato e cria uma Cadeia de Caracteres de URL.

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

   Site local Pesquisarr aparece na estrutura-região de formulário e apresenta cada endereço no bloco de rascunho.

   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ê executa o projeto, Ferramentas do Visual Studio para o Office executa o Adicionar-in e abre o Outlook.Abrir um item de contato para exibir mapa-região de formulário.A região de formulário mapa ele aparece como uma página na forma de qualquer item de contato que contém um endereço.

Para testar a região de formulário mapa-

1. Pressione F5 para executar o projeto.

   O Outlook abre.

2. No Outlook, no menu arquivo, aponte para Novoe, em seguida, clique em Contato.

3. No formulário do contato, tipo Ana Bezerra como o contato de nome e, em seguida, especifique os seguintes endereços de três.

   Tipo de endereço	Endereço
   Comercial	4567 Principal St. Buffalo, Nova York
   Home	1234 Norte St. Buffalo, Nova York
   Outros	3456 Principal St. Seattle, WA

4. Salvar e Fechar o item de contato.

5. Refazer Abrir Item de contato do Ana Bezerra.

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

   A região de formulário mapa ele aparece e exibe o Pesquisarr de site local.O Business, PáginPágina Iniciale Outros endereços Aparecerr no teclado de zero.No painel de zero, Selecionar um endereço que você deseja mapear.

Próximas etapas

Você pode saber mais sobre como personalizar a INTERFACE de um aplicativo Outlook estes tópicos:

• Para saber sobre como personalizar a Faixa de Opções de um item do Outlook, consulte Personalizando uma faixa de opções para Outlook.

Consulte também

Tarefas

Demonstra Passo a passo: Importação 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 que o Outlook exibindo uma região de formulário

Como: Acessar o item do Outlook que exibe a área de formulário

Conceitos

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

Criar regiões de formulário do Outlook

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

Associar uma região de formulário uma classe de mensagem do Outlook

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