İzlenecek yol: Outlook form bölgesi tasarlama

Özel form bölgeleri standart veya özel Microsoft Office Outlook formlarını genişletir. Bu kılavuzda, bir 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 Live 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 uygulaması ve proje türüne göre kullanılabilen özellikler.

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

  • Yeni bir Outlook VSTO Eklenti 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:

  • Microsoft Office geliştirici araçlarını içeren bir Visual Studio sürümü. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.

  • Outlook 2010 veya üzeri.

link to video Bu konunun video sürümü için bkz . Video nasıl yapılır: Outlook form bölgesi tasarlama.

Yeni bir Outlook VSTO Eklenti projesi oluşturma

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

Yeni bir Outlook VSTO Eklenti projesi oluşturmak için

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

  2. Yeni Proje 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'da Office projeleri oluşturma.

Outlook VSTO Eklenti projesine form bölgesi ekleme

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 Eklenti projesine form bölgesi eklemek için

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

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

  3. Yeni Öğe Ekle iletişim kutusunda Outlook Form Bölgesi'ni 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, Ayır'a 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şleyazı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ı 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 Gezgini MapItAddIn projesini genişletin ve ardından MapIt.cs veya MapIt.vb dosyasına çift tıklayarak Form Bölgesi Tasarım Aracı açın.

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

  3. Özellikler penceresinde Boyutdeğerini 664, 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'nun Ortak 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ında nasıl davranacağı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 Live 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'da MapIt.cs veya MapIt.vb'ye 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 FormRegionInitializingEventArgs özelliğini true olarak ayarlar Cancel 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'u açar. 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'ta, Giriş sekmesinde Yeni Öğ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ü Address
    İş 4567 Main St. Buffalo, NY
    Giriş Sayfası 1234 Kuzey 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'ta bu işlem, Kişiler için Adres Defteri'ni açarak veya Arama Kişiler'ne 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

Outlook uygulamasının kullanıcı arabirimini özelleştirme hakkında daha fazla bilgiyi şu konulardan öğrenebilirsiniz:

  • Outlook öğesinin şeridini özelleştirme hakkında bilgi edinmek için bkz . Outlook için şeridi özelleştirme.