Membuat wilayah formulir Outlook
Anda bisa menggunakan wilayah formulir untuk mengkustomisasi formulir Microsoft Office Outlook. Visual Studio menyediakan alat tingkat lanjut yang memudahkan Anda merancang, mengembangkan, dan men-debug wilayah formulir.
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.
Topik ini menyediakan informasi berikut:
Keuntungan menggunakan wilayah formulir
Wilayah formulir menawarkan banyak penyempurnaan atas pengembangan formulir Outlook tradisional:
Kustomisasi halaman default dari formulir standar apa pun.
Tambahkan hingga 12 halaman tambahan ke formulir standar apa pun.
Ganti atau tingkatkan formulir standar apa pun.
Tampilkan UI kustom di Panel Baca dan di Pemeriksa.
Untuk informasi selengkapnya, lihat Mengkustomisasi halaman formulir dan wilayah formulir.
Menambahkan wilayah formulir Outlook ke proyek Anda
Anda bisa menggunakan panduan Wilayah Formulir Outlook Baru untuk merancang wilayah formulir baru atau mengimpor wilayah formulir yang dirancang di Outlook. Selain itu, jika Anda memiliki wilayah formulir yang Anda gunakan di proyek Add-in Outlook VSTO lainnya, Anda bisa menggunakan kembali wilayah formulir yang sudah ada.
Membuat wilayah formulir baru dengan menggunakan wizard
Untuk membuat wilayah formulir, tambahkan item Wilayah Formulir Outlook ke proyek Add-in Outlook VSTO. Ini memulai panduan Wilayah Formulir Outlook Baru.
Gunakan panduan untuk menunjukkan apakah Anda ingin mendesain wilayah formulir baru atau mengimpor wilayah formulir yang dirancang di Outlook. Untuk informasi selengkapnya tentang mendesain wilayah formulir baru, lihat Menggunakan perancang wilayah formulir. Untuk informasi selengkapnya tentang menggunakan wilayah formulir yang dirancang di Outlook, lihat Mengimpor wilayah formulir yang dirancang di Outlook.
Gunakan wizard untuk menentukan tipe wilayah formulir yang ingin Anda buat. Tabel berikut ini menjelaskan setiap jenis wilayah formulir.
| Tipe kawasan | Deskripsi |
|---|---|
| Memisahkan | Menambahkan wilayah formulir sebagai halaman baru dalam formulir Outlook. |
| Berdampingan | Menambahkan wilayah formulir ke bagian bawah halaman default formulir Outlook. |
| Penggantian | Menambahkan wilayah formulir sebagai halaman baru yang menggantikan halaman default formulir Outlook. |
| Ganti semua | Mengganti seluruh formulir Outlook dengan wilayah formulir. |
Anda juga bisa menggunakan wizard untuk menentukan kondisi tampilan dan memilih tipe formulir yang akan diperluas. Untuk informasi selengkapnya, lihat Cara: Menambahkan wilayah formulir ke proyek Add-in Outlook.
Pilihan yang Anda buat dalam panduan memengaruhi opsi yang tersedia di halaman panduan lainnya. Misalnya, jika Anda memilih Bersebelahan atau Pisahkan di halaman Buat Wilayah Formulir Outlook Baru, bidang Judul dan Deskripsi tidak tersedia di teks Deskriptif pasokan dan pilih halaman preferensi tampilan Anda. Ini karena Outlook tidak menggunakan bidang ini ketika menampilkan wilayah formulir yang berdampingan atau terpisah.
File wilayah formulir
Saat Anda menyelesaikan panduan Wilayah Formulir Outlook Baru, Visual Studio secara otomatis menambahkan file berikut ke proyek Anda:
File kode wilayah formulir. File ini memiliki nama yang Anda tentukan untuk item Wilayah Formulir Outlook dalam kotak dialog Tambahkan Item Baru. Tambahkan kode untuk menangani peristiwa wilayah formulir ke file ini.
File kode desainer wilayah formulir. File ini berisi kode yang dihasilkan oleh perancang wilayah formulir dan tidak boleh diedit secara langsung.
File Penyimpanan Formulir Outlook (.ofs).
Catatan
File ini hanya ditambahkan ke proyek jika Anda mengimpor wilayah formulir yang dirancang di Outlook.
Kelas pabrik wilayah formulir
File kode wilayah formulir berisi kelas parsial IFormRegionFactory yang mengimplementasikan antarmuka. Ini adalah kelas pabrik wilayah formulir. Kelas pabrik wilayah formulir bertanggung jawab untuk membuat instans baru dari wilayah formulir.
Anda dapat menemukan kelas ini dengan memperluas wilayah Form Region Factory .
Wizard Wilayah Formulir Outlook Baru menambahkan atribut ke kelas ini yang menentukan nama internal wilayah formulir dan kelas pesan yang menampilkan wilayah formulir. Anda dapat mengubah atribut ini secara manual setelah file ditambahkan ke proyek.
Sebagian besar kelas pabrik wilayah formulir diimplementasikan dalam file perancang wilayah formulir. Namun, penanganan FormRegionInitializing aktivitas diekspos dalam file kode wilayah formulir. Anda dapat menggunakan penanganan aktivitas ini untuk menentukan apakah Outlook harus menampilkan wilayah formulir. Untuk informasi selengkapnya, lihat Menangani peristiwa wilayah formulir.
Menambahkan wilayah formulir yang sudah ada ke proyek Anda
Jika Anda memiliki wilayah formulir Outlook yang Anda gunakan di proyek Outlook lain, Anda bisa menggunakannya kembali di proyek Add-in Outlook VSTO Anda saat ini dengan menggunakan kotak dialog Tambahkan Item yang Sudah Ada.
Wilayah formulir yang ada harus memiliki file kode (.vb atau .cs); Anda tidak dapat menambahkan file Outlook Form Storage (.ofs) dengan menggunakan kotak dialog Tambahkan Item yang Ada. Namun, Anda dapat membuat wilayah formulir baru dengan mengimpor file Outlook Form Storage. Untuk informasi selengkapnya, lihat Cara: Menambahkan wilayah formulir ke proyek Add-in Outlook.
Menggunakan perancang wilayah formulir
Desainer wilayah formulir membantu Anda merancang tata letak dan tampilan wilayah formulir. Anda dapat menyeret kontrol terkelola ke permukaan perancang, mengklik dua kali kontrol untuk membuka penanganan aktivitas, dan mengatur properti di jendela Properti .
Catatan
Anda bisa menemukan properti yang memengaruhi cara wilayah formulir muncul di Outlook di bawah node Manifes di jendela Properti .
Perancang wilayah formulir hanya tersedia jika Anda memilih Desain Wilayah Formulir Baru di halaman Pilih bagaimana Anda ingin membuat wilayah formulir dari panduan Wilayah Formulir Outlook Baru.
Ada tiga cara untuk membuka perancang wilayah formulir:
Di Penjelajah Solusi, klik dua kali file kode wilayah formulir.
Di Penjelajah Solusi, klik kanan file kode wilayah formulir, lalu klik Tampilkan Perancang.
Di Penjelajah Solusi, pilih file kode wilayah formulir, lalu, pada menu Tampilan, klik Perancang.
Perancang wilayah formulir hanya mendukung kontrol terkelola. Anda tidak dapat menambahkan kontrol Outlook asli.
Mengimpor wilayah formulir yang dirancang di Outlook
Saat Anda mendesain di Outlook, Anda bisa menambahkan kontrol Outlook asli ke wilayah formulir. Kontrol Outlook asli memungkinkan Anda mengikat data Outlook pada waktu desain. Namun, Anda kemudian tidak dapat menggunakan perancang wilayah formulir untuk menambahkan kontrol terkelola atau mengubah desain wilayah formulir.
Anda bisa mengimpor wilayah formulir ke dalam proyek Add-in Outlook VSTO dengan menggunakan panduan Wilayah Formulir Outlook Baru. Pada halaman Pilih bagaimana Anda ingin membuat wilayah formulir, pilih Impor file Penyimpanan Formulir Outlook (.ofs). Anda kemudian dapat menelusuri ke lokasi file Penyimpanan Formulir Outlook (.ofs). (Outlook menyimpan wilayah formulir sebagai file .ofs .)
Wizard Wilayah Formulir Outlook Baru menyalin file .ofs ke direktori proyek dan menambahkan referensi kontrol ke file perancang wilayah formulir. Anda kemudian dapat menangani peristiwa kontrol dalam file kode wilayah formulir.
Untuk menangani peristiwa dalam proyek Visual Basic, pilih peristiwa dari daftar nama metode di bagian atas Editor Kode.
Untuk menangani peristiwa dalam proyek C#, berlangganan untuk mengontrol peristiwa dalam FormRegionShowing metode . Untuk informasi selengkapnya, lihat Cara: Berlangganan dan berhenti berlangganan dari peristiwa (panduan pemrograman C#).
Anda dapat mengubah properti wilayah formulir dalam InitializeManifest metode kelas pabrik wilayah formulir.
Catatan
Untuk mengimpor wilayah formulir, Anda harus bekerja dalam proyek yang menargetkan versi Outlook yang sama dengan yang telah Anda instal di komputer pengembangan. Misalnya, jika Anda menginstal Outlook 2010, mengimpor wilayah formulir hanya akan berfungsi dalam proyek yang dibuat dengan menggunakan templat proyek Add-in Outlook 2010.
Memperbarui desain wilayah formulir yang diimpor
Anda dapat menambahkan, menghapus, atau mengubah kontrol pada wilayah formulir. Sebelum Anda melakukan ini, cadangkan kode apa pun yang Anda tambahkan ke file kode wilayah formulir. Kemudian, buka file .ofs di Outlook, ubah wilayah formulir, lalu simpan perubahan. Gunakan wizard Wilayah Formulir Outlook Baru untuk mengimpor file .ofs yang dimodifikasi. Anda kemudian dapat menempelkan kode Anda ke dalam file kode wilayah formulir baru.
Menambahkan kode kustom ke wilayah formulir
Namespace Microsoft.Office.Tools.Outlook memberi Anda akses ke kelas yang mewakili wilayah formulir, item Outlook yang menampilkan wilayah formulir, dan item berguna lainnya. Item Wilayah Formulir Outlook secara otomatis menambahkan referensi ke rakitan ini dalam proyek dan menyisipkan pernyataan penggunaan atau Impor yang sesuai di bagian atas file kode wilayah formulir.
Anda bisa menggunakan kelas, metode, dan properti di Microsoft.Office.Interop.Outlook namespace layanan untuk menyelesaikan sebagian besar tugas pemrograman Outlook Anda. Untuk informasi selengkapnya tentang model objek Outlook, lihat Gambaran umum model objek Outlook. Untuk contoh tugas umum yang menggunakan model objek Outlook, lihat Solusi Outlook.
Menangani peristiwa wilayah formulir
Item Wilayah Formulir Outlook secara otomatis menambahkan tiga penanganan aktivitas berikut ke file kode wilayah formulir.
| Aktivitas | Deskripsi |
|---|---|
| FormRegionInitializing | Terjadi sebelum wilayah formulir diinisialisasi. Anda dapat memeriksa kondisi dalam penanganan aktivitas ini untuk menentukan apakah Outlook harus menampilkan wilayah formulir. Untuk informasi selengkapnya, lihat Cara: Mencegah Outlook menampilkan wilayah formulir. |
| FormRegionShowing | Terjadi setelah instans wilayah formulir dibuat tetapi sebelum wilayah formulir muncul. |
| FormRegionClosed | Terjadi sebelum wilayah formulir ditutup. |
Membangun proyek
Saat Anda membuat proyek Add-in Outlook VSTO yang berisi wilayah formulir, Visual Studio menambahkan informasi berikut ke registri:
Kunci untuk setiap kelas pesan yang terkait dengan satu atau beberapa wilayah formulir.
Entri untuk setiap wilayah formulir dan nilai terkait yang mewakili nama Add-in Outlook VSTO.
Outlook menggunakan informasi ini untuk memuat wilayah formulir.
Men-debug wilayah formulir
Anda dapat men-debug Add-in Outlook VSTO yang berisi wilayah formulir sama seperti Anda akan men-debug proyek Visual Studio lainnya. Saat Anda memulai debugger Visual Studio, Visual Studio secara otomatis memulai Outlook.
Untuk menampilkan wilayah formulir, Anda harus membuka item Outlook yang sesuai. Misalnya, jika wilayah formulir yang berdampingan ditambahkan ke bagian bawah item email, buka item email.
Menyebarkan wilayah formulir
Wilayah formulir disebarkan secara otomatis dengan Add-in Outlook VSTO terkait. Oleh karena itu, Anda tidak perlu melakukan tugas khusus untuk menyebarkan wilayah formulir. Untuk informasi selengkapnya tentang menyebarkan Add-in VSTO, lihat Menyebarkan solusi Office.
Topik terkait
| Judul | Deskripsi |
|---|---|
| Panduan untuk membuat wilayah formulir Outlook | Menyediakan informasi yang dapat membantu Anda mengoptimalkan wilayah formulir dan menghindari potensi masalah. |
| Cara: Menambahkan wilayah formulir ke proyek Add-in Outlook | Memperlihatkan kepada Anda cara membuat wilayah formulir untuk memperluas formulir Microsoft Office Outlook standar atau kustom dengan menggunakan panduan Wilayah Formulir Outlook Baru. |
| Mengaitkan wilayah formulir dengan kelas pesan Outlook | Menjelaskan cara menentukan item Microsoft Office Outlook mana yang menampilkan wilayah formulir dengan mengaitkan wilayah formulir dengan kelas pesan setiap item. |
| Panduan: Mendesain wilayah formulir Outlook | Memperlihatkan cara mendesain wilayah formulir kustom yang muncul sebagai halaman baru di jendela Pemeriksa item kontak. |
| Panduan: Mengimpor wilayah formulir yang dirancang di Outlook | Memperlihatkan cara mendesain wilayah formulir di Microsoft Office Outlook, lalu mengimpor wilayah formulir ke dalam proyek Add-in Outlook VSTO dengan menggunakan panduan Wilayah Formulir Outlook Baru. |
| Mengakses wilayah formulir pada waktu proses | Menjelaskan cara menulis kode untuk menampilkan, menyembunyikan, atau memodifikasi kontrol pada wilayah formulir, dan memungkinkan pengguna menjalankan kode dari area lain di proyek Anda dengan menggunakan Globals kelas . |
| Cara: Mencegah Outlook menampilkan wilayah formulir | Memperlihatkan cara mencegah Microsoft Office Outlook menampilkan wilayah formulir untuk item tertentu. |
| Memperlihatkan cara mengakses item Outlook tempat wilayah formulir muncul. | |
| Tindakan kustom di wilayah formulir Outlook | Menjelaskan cara mengaktifkan pengguna untuk merespons item Outlook. |