Compartilhar via

Demonstra Passo a passo: A criação de uma região de formulário do Outlook

  • Artigo

Regiões de formulário personalizado estendem os formulários de Microsoft Office Outlook padrão ou personalizados. Esta explicação passo a passo, você criará uma região de formulário personalizado que aparece como uma nova página na janela do Inspetor de propriedades de um item de contato. A 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 pesquisa site Local. Para obter informações sobre regiões de 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 2007 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

  • Criando um novo Outlook suplemento do projeto.

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

  • Criando 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çãoObservação

Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

Pré-requisitos

You need the following components to complete this walkthrough:

-

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).
  • Microsoft Office Outlook 2007 ou Outlook 2010.

link para vídeo Para obter uma versão de vídeo deste tópico, consulte vídeo How to: A criação de uma região de formulário do Outlook.

Criar um novo Outlook suplemento do projeto

Primeiro, crie um projeto de suplemento básico.

Para criar um novo Outlook suplemento do projeto

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

  2. No Novo projeto caixa de diálogo, selecione Create directory for solution.

  3. Salve o projeto para qualquer diretório.

    For more information, see Como: Criar projetos do Office em Visual Studio.

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

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

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

  1. Em Solution Explorer, selecione o MapItAddIn project.

  2. On the Project menu, click Add New Item.

  3. No Add New Item caixa de diálogo, selecione Região de formulário do Outlook, nomeie o arquivo MapIt e, em seguida, clique em Add.

    O nova Região de formulário do Outlook inicia o assistente.

  4. No Selecione como deseja criar a região de formulário página, clique em uma nova região de formulário do projetoe, em seguida, clique em próximo.

  5. Sobre o Selecione o tipo de região de formulário que você deseja criar página, clique em separadoe, em seguida, clique em próximo.

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

  6. No fornecer texto descritivo e selecionar suas preferências de exibição de página, digite Mapa- na nome caixa.

    Esse nome aparece na faixa de opções da janela do Inspetor quando o item de contato é aberto.

  7. Selecione Inspectors que estão no modo de redação e Inspectors que estiverem no modo de leiturae em seguida, clique em próximo.

  8. No identificar as classes de mensagem que exibirá a região de formulário página, clear Mensagem de email, selecione contatoe, em seguida, clique em Concluir.

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

Criar o Layout da região de formulário

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

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

  1. Em Solution Explorer, expanda o MapItAddIn de projeto e, em seguida, clique duas vezes em MapIt.cs ou MapIt.vb para abrir o Designer de região de formulário.

  2. O designer com o botão direito e clique em Propriedades.

  3. No Propriedades janela, defina tamanho para 664, 469.

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

  4. On the View menu, click Toolbox.

  5. Do Controles comuns guia da caixa de ferramentas, adicionar um WebBrowser à região de formulário.

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

Personalizar o comportamento da região de formulário

Adicione código para manipuladores de eventos de região de formulário para personalizar a forma de 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 deve exibir um mapa-região de formulário. Se ele exibe a região de formulário, o código navega para a pesquisa de Local Windows Live 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 Solution Explorer, clique com o botão direito do mouse em MapIt.cs ou MapIt.vb e, em seguida, clique em Exibir código.

    MapIt.cs ou MapIt.vb é aberto no Editor de código.

  2. Expanda o Fábrica da região de formulário região de código.

    A classe de fábrica da região de formulário chamado MapItFactory é exposto.

  3. Add the following code to the MapItFactory_FormRegionInitializing event handler. 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 contém um endereço, este código define o Cancel propriedade da FormRegionInitializingEventArgs classe true e a região de formulário não será exibida. Caso contrário, o suplemento eleva o FormRegionShowing eventos 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. Add the following code to the FormRegionShowing event handler. Esse código realiza as seguintes tarefas:

    • Concatena a cada endereço no item de contato e cria uma seqüência de caracteres de URL.

    • Chamadas de Navigate método o WebBrowser objeto e passa a URL string como um parâmetro.

    O site de pesquisa Local aparece no mapa-região de formulário e apresenta a cada endereço de 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);

}

Teste a região de formulário do Outlook

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

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

  1. Press F5 to run the project.

    O Outlook abre.

  2. No Outlook, crie um contato, realizando uma das seguintes tarefas:

    • No Outlook 2010, sobre o Home , clique em Novos itense, em seguida, clique em contato.

    • No Outlook 2007, sobre o arquivo , aponte para novae, em seguida, clique em contato.

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

    Tipo de endereço

    Address

    Negócios

    Amendoeira. Buffalo, NY.

    Home

    St do Norte 1234. Buffalo, NY.

    Other

    3456 Main St. Seattle, WA

  4. Salve e feche o item de contato.

  5. Reabra o Ana Bezerra item de contato.

  6. No Mostrar grupo de faixa de opções do item, clique em Mapa- para abrir o mapa-região de formulário.

    A região de formulário do mapa ele aparece e exibe o site de pesquisa Local. O Business, casa, e outros endereços aparecem no bloco de rascunho. No bloco de rascunho, 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 com estes tópicos:

Consulte também

Tarefas

Demonstra Passo a passo: A 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

Como: Acessar o Item do Outlook exibe a região de formulário

Conceitos

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

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 personalizadas nas regiões de formulário do Outlook

Outros recursos

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