İzlenecek yol: Outlook form bölgesi tasarlama

Şunlar için geçerlidir:yesnoVisual Studio Mac için Visual Studio noVisual Studio Code

Özel form bölgeleri standart veya özel Microsoft Office Outlook formlarını genişletir. Bu kılavuzda, kişi öğesinin Denetçi penceresinde yeni bir sayfa olarak görünen özel bir form bölgesi tasarlayacaksınız. Bu form bölgesi, adres bilgilerini Windows Canlı Yerel Arama Web sitesine göndererek kişi için listelenen her adresin haritasını görüntüler. Form bölgeleri hakkında bilgi için bkz. Outlook form bölgeleri oluşturma.

Şunlar için geçerlidir: Bu konudaki bilgiler, Outlook için VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulama ve proje türüne göre kullanılabilen özellikler.

Bu izlenecek yol aşağıdaki görevleri gösterir:

  • YENI bir Outlook VSTO Eklentisi projesi oluşturma.

  • VSTO Eklenti projesine form bölgesi ekleme.

  • Form bölgesinin düzenini tasarlama.

  • Form bölgesinin davranışını özelleştirme.

  • Outlook form bölgesini test etme.

Not

Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazıları için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için bkz. Visual Studio IDE'yi kişiselleştirme.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

VSTO Eklentisi projesi Outlook yeni bir proje oluşturma

İlk olarak temel bir VSTO Eklentisi projesi oluşturun.

VSTO Eklentisi projesi Outlook yeni bir proje oluşturmak için

  1. Visual Studio'da MapItAddIn adlı bir Outlook VSTO Eklentisi projesi oluşturun.

  2. Yeni Project iletişim kutusunda Çözüm için dizin oluştur'u seçin.

  3. Projeyi herhangi bir dizine kaydedin.

    Daha fazla bilgi için bkz. Nasıl yapılır: Visual Studio'de Office projeleri oluşturma.

Outlook VSTO Eklentisi projesine form bölgesi ekleme

bir Outlook VSTO Eklentisi çözümü, bir veya daha fazla Outlook form bölgesi öğesi içerebilir. Yeni Outlook Form Bölgesi sihirbazını kullanarak projenize form bölgesi öğesi ekleyin.

Outlook VSTO Eklentisi projesine form bölgesi eklemek için

  1. Çözüm Gezgini'daMapItAddIn projesini seçin.

  2. Project menüsünde Yeni Öğe Ekle'ye tıklayın.

  3. Yeni Öğe Ekle iletişim kutusunda Form Bölgesi'ni Outlook seçin, dosyayı MapIt olarak adlandırın ve ekle'ye tıklayın.

    NewOutlook Form Bölgesi sihirbazı başlatılır.

  4. Form bölgesini nasıl oluşturmak istediğinizi seçin sayfasında Yeni form bölgesi tasarla'ya ve ardından İleri'ye tıklayın.

  5. Oluşturmak istediğiniz form bölgesi türünü seçin sayfasında, Ayrı'ya ve ardından İleri'ye tıklayın.

    Ayrı bir form bölgesi, Outlook formuna yeni bir sayfa ekler. Form bölgesi türleri hakkında daha fazla bilgi için bkz. Outlook form bölgeleri oluşturma.

  6. Açıklayıcı metin sağlayın ve görüntüleme tercihlerinizi seçin sayfasında Ad kutusuna Eşle yazın.

    Bu ad, kişi öğesi açıkken Denetçi penceresinin Şeridinde görünür.

  7. Oluşturma modundaki Denetçiler'i ve okuma modundaki Denetçiler'i seçin ve ardından İleri'ye tıklayın.

  8. Bu form bölgesini görüntüleyecek ileti sınıflarını tanımla sayfasında Posta İletisi'ni temizleyin, Kişi'yi seçin ve son'a tıklayın.

    Projenize bir MapIt.cs veya MapIt.vb dosyası eklenir.

Form bölgesinin düzenini tasarlama

Form bölgesi tasarımcısını kullanarak form bölgelerini görsel olarak geliştirin. Yönetilen denetimleri form bölgesi tasarımcısının yüzeyine sürükleyebilirsiniz. Denetim düzenini ve görünümünü ayarlamak için tasarımcıyı ve Özellikler penceresini kullanın.

Form bölgesinin düzenini tasarlamak için

  1. Çözüm GezginiMapItAddIn projesini genişletin ve ardından MapIt.cs veya MapIt.vb dosyasına çift tıklayarak Form Bölgesi Tasarımcısı'nı açın.

  2. Tasarımcıya sağ tıklayın ve ardından Özellikler'e tıklayın.

  3. Özellikler penceresinde Boyut'u664, 469 olarak ayarlayın.

    Bu, form bölgesinin haritayı görüntüleyecek kadar büyük olmasını sağlar.

  4. Görünüm menüsünde Araç Kutusu'na tıklayın.

  5. Araç Kutusu'nunOrtak Denetimler sekmesinden form bölgesine bir WebBrowser ekleyin.

    WebBrowser kişi için listelenen her adresin haritasını görüntüler.

Form bölgesinin davranışını özelleştirme

Form bölgesinin çalışma zamanındaki davranışını özelleştirmek için form bölgesi olay işleyicilerine kod ekleyin. Bu form bölgesi için kod, bir Outlook öğesinin özelliklerini inceler ve Eşle form bölgesinin görüntülenip görüntülenmeyeceğini belirler. Form bölgesini görüntülerse, kod Windows Canlı Yerel Arama'ya gider ve Outlook kişi öğesinde listelenen her adresin haritasını yükler.

Form bölgesinin davranışını özelleştirmek için

  1. Çözüm Gezgini'daMapIt.cs veya MapIt.vb dosyasına sağ tıklayın ve ardından Kodu Görüntüle'ye tıklayın.

    MapIt.cs veya MapIt.vb , Kod Düzenleyicisi'nde açılır.

  2. Form Bölgesi Fabrika kod bölgesini genişletin.

    adlı MapItFactory form bölgesi fabrika sınıfı kullanıma sunuldu.

  3. Olay işleyicisine MapItFactory_FormRegionInitializing aşağıdaki kodu ekleyin. Kullanıcı bir kişi öğesi açtığında bu olay işleyicisi çağrılır. Aşağıdaki kod, kişi öğesinin bir adres içerip içermediğini belirler. Kişi öğesi bir adres içermiyorsa, bu kod sınıfın CancelFormRegionInitializingEventArgs özelliğini true olarak ayarlar ve form bölgesi görüntülenmez. Aksi takdirde VSTO Eklentisi olayı tetikler FormRegionShowing ve form bölgesini görüntüler.

    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. Olay işleyicisine FormRegionShowing aşağıdaki kodu ekleyin. Bu kod aşağıdaki görevleri gerçekleştirir:

    • Kişi öğesindeki her adresi birleştirir ve bir URL dizesi oluşturur.

    • nesnesinin NavigateWebBrowser yöntemini çağırır ve URL dizesini parametre olarak geçirir.

      Yerel Arama Web sitesi, Eşle Form bölgesinde görünür ve her adresi karalama panelinde gösterir.

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

Outlook form bölgesini test edin

Projeyi çalıştırdığınızda Visual Studio Outlook açılır. Eşle form bölgesini görüntülemek için bir kişi öğesi açın. Eşle form bölgesi, adres içeren herhangi bir kişi öğesi biçiminde bir sayfa olarak görünür.

Eşle form bölgesini test etmek için

  1. Projeyi çalıştırmak için F5 tuşuna basın.

    Outlook açılır.

  2. Outlook Giriş sekmesindeYeni Öğeler'e ve ardından Kişi'ye tıklayın.

  3. Kişi formunda, kişi adı olarak Ann Beebe yazın ve aşağıdaki üç adresi belirtin.

    Adres Türü Adres
    İş 4567 Main St. Buffalo, NY
    Giriş Ekranı 1234 North St. Buffalo, NY
    Diğer 3456 Main St. Seattle, WA
  4. Kişi öğesini kaydedin ve kapatın.

  5. Ann Beebe kişi öğesini yeniden açın.

    Outlook'da bu işlem, Kişiler için Adres Defteri'ni açarak veya Kişileri Ara'ya Ann Beebe yazarak Bul grubunda yapılabilir.

  6. Öğenin Şeridinin Göster grubunda Eşle'ye tıklayarak Eşle form bölgesini açın.

    Eşle form bölgesi görüntülenir ve Yerel Arama Web sitesini görüntüler. İş, Ev ve Diğer adresler karalama panelinde görünür. Karalama panelinde eşlemek istediğiniz adresi seçin.

Sonraki adımlar

Aşağıdaki konulardan bir Outlook uygulamasının kullanıcı arabirimini özelleştirme hakkında daha fazla bilgi edinebilirsiniz:

Ayrıca bkz.