Sdílet prostřednictvím

Návod: Návrh oblasti formuláře aplikace Outlook

  • Článek

Vlastní oblasti formulářů rozšiřují standardní nebo vlastní formuláře aplikace Microsoft Office Outlook. V tomto názorném postupu navrhnete vlastní oblast formuláře, která se zobrazí jako nová stránka v okně inspektoru položky kontaktu. Tato oblast formuláře zobrazí mapu každé adresy, která je uvedená pro kontakt, odesláním informací o adrese na web služby Windows Live Local Search. Informace o oblastech formulářů najdete v tématu Vytváření oblastí formuláře Aplikace Outlook.

Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO pro Outlook. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Tento návod znázorňuje následující úlohy:

  • Vytvoření nového projektu doplňku VSTO aplikace Outlook

  • Přidání oblasti formuláře do projektu doplňku VSTO

  • Návrh rozložení oblasti formuláře

  • Přizpůsobení chování oblasti formuláře

  • Testování oblasti formuláře Aplikace Outlook.

Poznámka:

Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí sady Visual Studio.

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

link to video Video verze tohoto tématu najdete v tématu Video postupy: Návrh oblasti formuláře Outlooku.

Vytvoření nového projektu doplňku VSTO aplikace Outlook

Nejprve vytvořte základní projekt doplňku VSTO.

Vytvoření nového projektu doplňku VSTO aplikace Outlook

  1. V sadě Visual Studio vytvořte projekt doplňku VSTO aplikace Outlook s názvem MapItAddIn.

  2. V dialogovém okně Nový projekt vyberte Vytvořit adresář pro řešení.

  3. Uložte projekt do libovolného adresáře.

    Další informace naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

Přidání oblasti formuláře do projektu doplňku Outlook VSTO

Řešení doplňku Outlook VSTO může obsahovat jednu nebo více položek formuláře Aplikace Outlook. Přidejte do projektu položku oblasti formuláře pomocí průvodce Nová oblast formuláře aplikace Outlook.

Přidání oblasti formuláře do projektu doplňku Outlook VSTO

  1. V Průzkumník řešení vyberte projekt MapItAddIn.

  2. V nabídce Projekt klepněte na tlačítko Přidat novou položku.

  3. V dialogovém okně Přidat novou položku vyberte oblast formuláře aplikace Outlook, pojmenujte soubor MapIt a klepněte na tlačítko Přidat.

    Spustí se Průvodce oblastí formuláře NewOutlook.

  4. Na stránce Vybrat, jak chcete vytvořit oblast formuláře, klepněte na tlačítko Návrh nové oblasti formuláře a potom klepněte na tlačítko Další.

  5. Na stránce Vyberte typ oblasti formuláře, kterou chcete vytvořit, klepněte na tlačítko Oddělit a potom klepněte na tlačítko Další.

    Samostatná oblast formuláře přidá novou stránku do formuláře Outlooku. Další informace o typech oblastí formuláře naleznete v tématu Vytvoření oblastí formuláře aplikace Outlook.

  6. Na stránce Zadejte popisný text a vyberte stránku předvoleb zobrazení, do pole Název zadejte Mapovat.

    Tento název se zobrazí na pásu karet okna inspektoru, když je položka kontaktu otevřená.

  7. Vyberte inspektory, které jsou v režimu psaní, a inspektory, které jsou v režimu čtení, a potom klepněte na tlačítko Další.

  8. Na stránce Identifikace tříd zpráv, které zobrazí tuto stránku oblasti formuláře, zrušte zaškrtnutí políčka Pošta, vyberte Kontakt a klikněte na tlačítko Dokončit.

    Do projektu se přidá soubor MapIt.cs nebo MapIt.vb .

Návrh rozložení oblasti formuláře

Vizuální vývoj oblastí formulářů pomocí návrháře oblastí formuláře Spravované ovládací prvky můžete přetáhnout na plochu návrháře oblastí formuláře. Pomocí návrháře a okna Vlastnosti můžete upravit rozložení a vzhled ovládacího prvku.

Návrh rozložení oblasti formuláře

  1. V Průzkumník řešení rozbalte projekt MapItAddIn a poté poklikáním na MapIt.cs nebo MapIt.vb otevřete Návrhář oblasti formuláře.

  2. Klikněte pravým tlačítkem myši na návrháře a potom klikněte na příkaz Vlastnosti.

  3. V okně Vlastnosti nastavte velikost na 664, 469.

    Tím zajistíte, že oblast formuláře bude dostatečně velká, aby se zobrazila mapa.

  4. V nabídce Zobrazení klikněte na Panel nástrojů.

  5. Na kartě Běžné ovládací prvky panelu nástrojů přidejte webBrowser do oblasti formuláře.

    WebBrowser zobrazí mapu každé adresy, která je uvedená pro kontakt.

Přizpůsobení chování oblasti formuláře

Přidejte kód do obslužných rutin událostí oblasti formuláře pro přizpůsobení způsobu, jakým se oblast formuláře chová za běhu. V této oblasti formuláře kód zkontroluje vlastnosti položky aplikace Outlook a určuje, zda se má zobrazit oblast formuláře Mapovat. Pokud se zobrazí oblast formuláře, kód přejde do služby Windows Live Local Search a načte mapu každé adresy uvedené v položce kontaktu aplikace Outlook.

Přizpůsobení chování oblasti formuláře

  1. V Průzkumník řešení klepněte pravým tlačítkem na MapIt.cs nebo MapIt.vb a potom klepněte na tlačítko Zobrazit kód.

    MapIt.cs nebo MapIt.vb se otevře v Editoru kódu.

  2. Rozbalte oblast kódu objektu pro vytváření oblastí formuláře.

    Třída MapItFactory objektu pro vytváření oblastí formuláře je vystavena.

  3. Do obslužné rutiny MapItFactory_FormRegionInitializing události přidejte následující kód. Tato obslužná rutina události se volá, když uživatel otevře položku kontaktu. Následující kód určuje, zda položka kontaktu obsahuje adresu. Pokud položka kontaktu neobsahuje adresu, nastaví tento kód Cancel vlastnost FormRegionInitializingEventArgs třídy na true a oblast formuláře se nezobrazí. V opačném případě doplněk VSTO vyvolá FormRegionShowing událost a zobrazí oblast formuláře.

    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. Do obslužné rutiny FormRegionShowing události přidejte následující kód. Tento kód provádí následující úlohy:

    • Zřetězí každou adresu v položce kontaktu a vytvoří řetězec adresy URL.

    • Navigate Volá metodu objektu WebBrowser a předá řetězec adresy URL jako parametr.

      Web místního vyhledávání se zobrazí v oblasti formuláře Mapa a zobrazí každou adresu na pomocném panelu.

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

}

Otestování oblasti formuláře Aplikace Outlook

Když projekt spustíte, Visual Studio otevře Outlook. Otevřete položku kontaktu, abyste zobrazili oblast formuláře Mapovat. Oblast formuláře Mapovat se zobrazí jako stránka ve formě libovolné položky kontaktu, která obsahuje adresu.

Otestování oblasti formuláře Mapovat

  1. Stisknutím klávesy F5 spusťte projekt.

    Otevře se Outlook.

  2. V Outlooku klepněte na kartě Domů na položku Nové položky a potom klepněte na tlačítko Kontakt.

  3. Ve formuláři kontaktu zadejte jako jméno kontaktu Ann Beebe a zadejte následující tři adresy.

    Typ adresy Address
    Organizace 4567 Main St. Buffalo, NY
    Domovská stránka 1234 North St. Buffalo, NY
    Další 3456 Main St. Seattle, WA

  4. Uložte a zavřete položku kontaktu.

  5. Znovu otevřete položku kontaktu Ann Beebe.

    V Outlooku to můžete udělat ve skupině Najít tak, že otevřete adresář kontaktů nebo zadáte Ann Beebe do vyhledávacího Lidé.

  6. Ve skupině Zobrazit pás karet položky klikněte na Mapovat a otevřete oblast formuláře Mapovat.

    Zobrazí se oblast formuláře Mapovat a zobrazí web místního vyhledávání. Adresy Business, Home a Other se zobrazují na pomocném panelu. Na pomocném panelu vyberte adresu, kterou chcete namapovat.

Další kroky

Další informace o tom, jak přizpůsobit uživatelské rozhraní aplikace Outlook, najdete v těchto tématech:

Související obsah