Panduan: Mendesain wilayah formulir Outlook

Wilayah formulir kustom memperluas formulir Microsoft Office Outlook standar atau kustom. Dalam panduan ini, Anda akan merancang wilayah formulir kustom yang muncul sebagai halaman baru di jendela Pemeriksa item kontak. Wilayah formulir ini menampilkan peta setiap alamat yang tercantum untuk kontak, dengan mengirim informasi alamat ke situs Web Windows Live Local Search. Untuk informasi tentang wilayah formulir, lihat Membuat wilayah formulir Outlook.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO untuk Outlook. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

• Membuat proyek Add-in Outlook VSTO baru.

• Menambahkan wilayah formulir ke proyek Add-in VSTO.

• Merancang tata letak wilayah formulir.

• Menyesuaikan perilaku wilayah formulir.

• Menguji wilayah formulir Outlook.

Catatan

Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE Visual Studio.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

• Edisi Visual Studio yang menyertakan alat pengembang Microsoft Office. Untuk informasi selengkapnya, lihat Mengonfigurasi komputer untuk mengembangkan solusi Office.

• Outlook 2010 atau yang lebih baru.

Untuk versi video topik ini, lihat Video cara: Mendesain wilayah formulir Outlook.

Membuat proyek Add-in Outlook VSTO baru

Pertama-tama buat proyek Add-in VSTO dasar.

Untuk membuat proyek Add-in Outlook VSTO baru

1. Di Visual Studio, buat proyek Add-in Outlook VSTO dengan nama MapItAddIn.

2. Dalam kotak dialog Proyek Baru, pilih Buat direktori untuk solusi.

3. Simpan proyek ke direktori apa pun.

   Untuk informasi selengkapnya, lihat Cara: Membuat proyek Office di Visual Studio.

Menambahkan wilayah formulir ke proyek Add-in Outlook VSTO

Solusi Add-in Outlook VSTO bisa berisi satu atau beberapa item wilayah formulir Outlook. Tambahkan item wilayah formulir ke proyek Anda dengan menggunakan panduan Wilayah Formulir Outlook Baru.

Untuk menambahkan wilayah formulir ke proyek Add-in Outlook VSTO

1. Di Penjelajah Solusi, pilih proyek MapItAddIn.

2. Pada menu Proyek, klik Tambahkan Item Baru.

3. Dalam kotak dialog Tambahkan Item Baru, pilih Wilayah Formulir Outlook, beri nama file MapIt, lalu klik Tambahkan.

   Wizard Wilayah Formulir NewOutlook dimulai.

4. Pada halaman Pilih bagaimana Anda ingin membuat wilayah formulir, klik Desain wilayah formulir baru, lalu klik Berikutnya.

5. Pada halaman Pilih tipe wilayah formulir yang ingin Anda buat , klik Pisahkan, lalu klik Berikutnya.

   Wilayah formulir terpisah menambahkan halaman baru ke formulir Outlook. Untuk informasi selengkapnya tentang tipe wilayah formulir, lihat Membuat wilayah formulir Outlook.

6. Pada halaman Sediakan teks deskriptif dan pilih preferensi tampilan Anda, ketik Petakan di kotak Nama .

   Nama ini muncul pada Pita jendela Pemeriksa saat item kontak terbuka.

7. Pilih Pemeriksa yang berada dalam mode tulis dan Pemeriksa yang berada dalam mode baca, lalu klik Berikutnya.

8. Pada halaman Identifikasi kelas pesan yang akan menampilkan wilayah formulir ini, hapus Pesan Email, pilih Kontak, lalu klik Selesai.

   File MapIt.cs atau MapIt.vb ditambahkan ke proyek Anda.

Mendesain tata letak wilayah formulir

Kembangkan wilayah formulir secara visual dengan menggunakan perancang wilayah formulir. Anda dapat menyeret kontrol terkelola ke permukaan perancang wilayah formulir. Gunakan perancang dan jendela Properti untuk menyesuaikan tata letak dan tampilan kontrol.

Untuk merancang tata letak wilayah formulir

1. Di Penjelajah Solusi, perluas proyek MapItAddIn, lalu klik dua kali MapIt.cs atau MapIt.vb untuk membuka Perancang Wilayah Formulir.

2. Klik kanan perancang, lalu klik Properti.

3. Di jendela Properti , atur Ukuran ke 664, 469.

   Ini memastikan bahwa wilayah formulir akan cukup besar untuk menampilkan peta.

4. Pada menu Tampilan, klik Kotak Alat.

5. Dari tab Kontrol Umum kotak Alat, tambahkan WebBrowser ke wilayah formulir.

   WebBrowser akan menampilkan peta setiap alamat yang tercantum untuk kontak tersebut.

Mengkustomisasi perilaku wilayah formulir

Tambahkan kode untuk membentuk penanganan aktivitas wilayah untuk menyesuaikan cara wilayah formulir berperilaku pada waktu proses. Untuk wilayah formulir ini, kode memeriksa properti item Outlook dan menentukan apakah akan menampilkan wilayah formulir Map It. Jika menampilkan wilayah formulir, kode menavigasi ke Windows Live Local Search dan memuat peta setiap alamat yang tercantum dalam item kontak Outlook.

Untuk mengkustomisasi perilaku wilayah formulir

1. Di Penjelajah Solusi, klik kanan MapIt.cs atau MapIt.vb, lalu klik Tampilkan Kode.

   MapIt.cs atau MapIt.vb terbuka di Editor Kode.

2. Perluas wilayah kode Form Region Factory.

   Kelas pabrik wilayah formulir bernama MapItFactory diekspos.

3. Tambahkan kode berikut ke penanganan aktivitas MapItFactory_FormRegionInitializing. Penanganan aktivitas ini dipanggil ketika pengguna membuka item kontak. Kode berikut menentukan apakah item kontak berisi alamat. Jika item kontak tidak berisi alamat, kode ini mengatur Cancel properti FormRegionInitializingEventArgs kelas ke true dan wilayah formulir tidak ditampilkan. Jika tidak, Add-in VSTO menaikkan FormRegionShowing peristiwa dan menampilkan wilayah formulir.

   C#

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

   VB

   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
   

4. Tambahkan kode berikut ke penanganan aktivitas FormRegionShowing. Kode ini melakukan tugas-tugas berikut:

   • Menggabungkan setiap alamat dalam item kontak dan membuat string URL.

   • Navigate Memanggil metode WebBrowser objek dan meneruskan string URL sebagai parameter.

     Situs Web Pencarian Lokal muncul di wilayah formulir Peta ini dan menyajikan setiap alamat di pad awal.

     C#

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

     VB

     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
     

   ---

Menguji wilayah formulir Outlook

Saat Anda menjalankan proyek, Visual Studio membuka Outlook. Buka item kontak untuk melihat wilayah formulir Petakan. Wilayah formulir Petakan Ini muncul sebagai halaman dalam bentuk item kontak apa pun yang berisi alamat.

Untuk menguji wilayah formulir Map It

1. Tekan F5 untuk menjalankan proyek.

   Outlook terbuka.

2. Di Outlook, pada tab Beranda , klik Item Baru, lalu klik Kontak.

3. Dalam formulir kontak, ketik Ann Beebe sebagai nama kontak, lalu tentukan tiga alamat berikut.

   Jenis Alamat	Alamat
   Bisnis	4567 Main St. Buffalo, NY
   Rumah	1234 North St. Buffalo, NY
   Lainnya	3456 Main St. Seattle, WA

4. Simpan dan tutup item kontak.

5. Buka kembali item kontak Ann Beebe .

   Di Outlook, ini dapat dilakukan di grup Temukan dengan membuka Buku Alamat untuk Kontak atau mengetik Ann Beebe ke dalam Orang Pencarian.

6. Di Perlihatkan grup Pita item, klik Petakan untuk membuka wilayah formulir Petakan.

   Wilayah formulir Petakan Ini muncul, dan menampilkan situs Web Pencarian Lokal. Alamat Bisnis, Rumah, dan Lainnya muncul di pad awal. Di pad awal, pilih alamat yang ingin Anda petakan.

Langkah berikutnya

Anda bisa mempelajari selengkapnya tentang cara mengkustomisasi UI aplikasi Outlook dari topik-topik ini:

• Untuk mempelajari tentang cara mengkustomisasi pita item Outlook, lihat Mengkustomisasi pita untuk Outlook.

Konten terkait

• Mengakses wilayah formulir pada waktu proses
• Membuat wilayah formulir Outlook
• Panduan untuk membuat wilayah formulir Outlook
• Panduan: Mengimpor wilayah formulir yang dirancang di Outlook
• Cara: Menambahkan wilayah formulir ke proyek Add-in Outlook
• Mengaitkan wilayah formulir dengan kelas pesan Outlook
• Tindakan kustom di wilayah formulir Outlook
• Cara: Mencegah Outlook menampilkan wilayah formulir