Share via

Przewodnik: projektowanie regionu formularza programu Outlook

  • Artykuł

Niestandardowe regiony formularzy rozszerzają standardowe lub niestandardowe formularze programu Microsoft Office Outlook. W tym przewodniku zaprojektujesz niestandardowy region formularza, który będzie wyświetlany jako nowa strona w oknie Inspector (Inspektor) elementu kontaktu. Ten region formularza wyświetla mapę każdego adresu wymienionego dla kontaktu, wysyłając informacje o adresie do witryny sieci Web wyszukiwania lokalnego systemu Windows Live. Aby uzyskać informacje na temat regionów formularzy, zobacz Tworzenie regionów formularzy programu Outlook.

Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W instruktażu przedstawiono następujące zagadnienia:

  • Tworzenie nowego projektu dodatku programu Outlook VSTO.

  • Dodawanie regionu formularza do projektu dodatku VSTO.

  • Projektowanie układu regionu formularza.

  • Dostosowywanie zachowania regionu formularza.

  • Testowanie regionu formularza programu Outlook.

Uwaga

Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE programu Visual Studio.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

link to video Aby zapoznać się z wersją wideo tego tematu, zobacz Wideo: Projektowanie regionu formularza programu Outlook.

Tworzenie nowego projektu dodatku programu Outlook VSTO

Najpierw utwórz podstawowy projekt dodatku VSTO.

Aby utworzyć nowy projekt dodatku programu Outlook VSTO

  1. W programie Visual Studio utwórz projekt dodatku VSTO programu Outlook o nazwie MapItAddIn.

  2. W oknie dialogowym Nowy projekt wybierz pozycję Utwórz katalog dla rozwiązania.

  3. Zapisz projekt w dowolnym katalogu.

    Aby uzyskać więcej informacji, zobacz How to: Create Office projects in Visual Studio (Jak tworzyć projekty pakietu Office w programie Visual Studio).

Dodawanie regionu formularza do projektu dodatku VSTO programu Outlook

Rozwiązanie dodatku VSTO programu Outlook może zawierać co najmniej jeden element regionu formularza programu Outlook. Dodaj element regionu formularza do projektu przy użyciu kreatora Nowy region formularza programu Outlook.

Aby dodać region formularza do projektu dodatku VSTO programu Outlook

  1. W Eksplorator rozwiązań wybierz projekt MapItAddIn.

  2. W menu Project (Projekt) kliknij pozycję Add New Item (Dodaj nowy element).

  3. W oknie dialogowym Dodawanie nowego elementu wybierz pozycję Region formularza programu Outlook, nadaj plikowi nazwę MapIt, a następnie kliknij przycisk Dodaj.

    Zostanie uruchomiony kreator NewOutlook Form Region .

  4. Na stronie Wybierz sposób tworzenia regionu formularza kliknij pozycję Projektowanie nowego regionu formularza, a następnie kliknij przycisk Dalej.

  5. Na stronie Wybierz typ regionu formularza, który chcesz utworzyć , kliknij przycisk Oddzielny, a następnie kliknij przycisk Dalej.

    Oddzielny region formularza dodaje nową stronę do formularza programu Outlook. Aby uzyskać więcej informacji na temat typów regionów formularzy, zobacz Tworzenie regionów formularzy programu Outlook.

  6. Na stronie Podaj tekst opisowy i wybierz stronę preferencji wyświetlania wpisz Mapuj go w polu Nazwa.

    Ta nazwa jest wyświetlana na wstążce okna Inspector (Inspektor), gdy element kontaktu jest otwarty.

  7. Wybierz pozycję Inspektorzy w trybie redagowania i Inspektorzy w trybie odczytu, a następnie kliknij przycisk Dalej.

  8. Na stronie Identyfikowanie klas wiadomości, które będą wyświetlać ten region formularza, wyczyść pole Wiadomość e-mail, wybierz pozycję Kontakt, a następnie kliknij przycisk Zakończ.

    Do projektu jest dodawany plik MapIt.cs lub MapIt.vb .

Projektowanie układu regionu formularza

Wizualne tworzenie regionów formularzy przy użyciu projektanta regionów formularzy. Kontrolki zarządzane można przeciągać na powierzchnię projektanta regionów formularzy. Użyj projektanta i okna Właściwości , aby dostosować układ i wygląd kontrolki.

Aby zaprojektować układ regionu formularza

  1. W Eksplorator rozwiązań rozwiń projekt MapItAddIn, a następnie kliknij dwukrotnie plik MapIt.cs lub MapIt.vb, aby otworzyć Projektant Region formularza.

  2. Kliknij prawym przyciskiem myszy projektanta, a następnie kliknij polecenie Właściwości.

  3. W oknie Właściwości ustaw wartość Rozmiar na 664, 469.

    Dzięki temu region formularza będzie wystarczająco duży, aby wyświetlić mapę.

  4. W menu Widok kliknij pozycję Przybornik.

  5. Na karcie Wspólne kontrolki przybornika dodaj element WebBrowser do regionu formularza.

    W aplikacji WebBrowser zostanie wyświetlona mapa każdego adresu wymienionego dla kontaktu.

Dostosowywanie zachowania regionu formularza

Dodaj kod do procedur obsługi zdarzeń regionu, aby dostosować sposób działania regionu formularza w czasie wykonywania. W tym regionie formularza kod sprawdza właściwości elementu programu Outlook i określa, czy ma być wyświetlany region formularza Mapuj. Jeśli wyświetla region formularza, kod przechodzi do usługi Windows Live Local Search i ładuje mapę każdego adresu wymienionego w elemencie kontaktowym programu Outlook.

Aby dostosować zachowanie regionu formularza

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik MapIt.cs lub MapIt.vb, a następnie kliknij polecenie Wyświetl kod.

    Plik MapIt.cs lub MapIt.vb zostanie otwarty w Edytorze kodu.

  2. Rozwiń region kodu fabryki regionów formularzy .

    Udostępniono klasę fabryki regionów formularzy o nazwie MapItFactory .

  3. Dodaj następujący kod do programu obsługi zdarzeń MapItFactory_FormRegionInitializing . Ta procedura obsługi zdarzeń jest wywoływana, gdy użytkownik otworzy element kontaktu. Poniższy kod określa, czy element kontaktu zawiera adres. Jeśli element kontaktu nie zawiera adresu, ten kod ustawia Cancel właściwość FormRegionInitializingEventArgs klasy na true , a region formularza nie jest wyświetlany. W przeciwnym razie dodatek VSTO zgłasza FormRegionShowing zdarzenie i wyświetla region formularza.

    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. Dodaj następujący kod do programu obsługi zdarzeń FormRegionShowing . Ten kod wykonuje następujące zadania:

    • Łączy każdy adres w elemencie kontaktu i tworzy ciąg adresu URL.

    • Wywołuje metodę NavigateWebBrowser obiektu i przekazuje ciąg adresu URL jako parametr.

      Witryna sieci Web wyszukiwania lokalnego jest wyświetlana w regionie formularza Mapuj ją i przedstawia każdy adres w okienku tymczasowym.

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

}

Testowanie regionu formularza programu Outlook

Po uruchomieniu projektu program Visual Studio otwiera program Outlook. Otwórz element kontaktu, aby wyświetlić region Formularza mapowania. Region Formularza Mapowanie jest wyświetlany jako strona w postaci dowolnego elementu kontaktu zawierającego adres.

Aby przetestować region formularza Mapuj

  1. Naciśnij klawisz F5 , aby uruchomić projekt.

    Zostanie otwarty program Outlook.

  2. W programie Outlook na karcie Narzędzia główne kliknij pozycję Nowe elementy, a następnie kliknij pozycję Kontakt.

  3. W formularzu kontaktu wpisz Ann Beebe jako nazwę kontaktu, a następnie określ następujące trzy adresy.

    Typ adresu Address
    Firma 4567 Main St. Buffalo, NY
    Strona główna 1234 North St. Buffalo, NY
    Inne 3456 Main St. Seattle, WA

  4. Zapisz i zamknij element kontaktu.

  5. Otwórz ponownie element kontaktu Ann Beebe.

    W programie Outlook można to zrobić w grupie Znajdź, otwierając książkę adresową dla kontaktów lub wpisując ann Beebe w polu Wyszukaj Osoby.

  6. W grupie Pokaż wstążkę elementu kliknij pozycję Mapuj, aby otworzyć region Mapuj go w formularzu.

    Zostanie wyświetlony region Mapuj formularz i zostanie wyświetlona witryna sieci Web wyszukiwania lokalnego. Adresy Business, Home i Other są wyświetlane w okienku tymczasowym. W okienku do zera wybierz adres, który chcesz mapować.

Następne kroki

Więcej informacji na temat dostosowywania interfejsu użytkownika aplikacji Outlook można znaleźć w następujących tematach:

Powiązana zawartość