Dukungan MAPI di MFC

MFC menyediakan dukungan untuk subset Antarmuka Program Aplikasi (MAPI) Microsoft Olahpesan di kelas CDocument. Secara khusus, CDocument memiliki fungsi anggota yang menentukan apakah dukungan email ada di komputer pengguna akhir dan, jika demikian, aktifkan perintah Kirim Email yang ID perintah standarnya ID_FILE_SEND_MAIL. Fungsi handler MFC untuk perintah ini memungkinkan pengguna mengirim dokumen melalui surat elektronik.

Menyediakan perintah Kirim Email di aplikasi Anda sangat mudah. MFC menyediakan implementasi untuk mengemas dokumen (yaitu, CDocumentobjek -turunan) sebagai lampiran dan mengirimkannya sebagai email. Lampiran ini setara dengan perintah Simpan File yang menyimpan (menserialisasikan) konten dokumen ke pesan email. Implementasi ini memanggil klien email di komputer pengguna untuk memberi pengguna kesempatan untuk menangani email dan untuk menambahkan subjek dan teks pesan ke pesan email. Pengguna melihat antarmuka pengguna aplikasi email yang mereka kenal. Fungsionalitas ini disediakan oleh dua CDocument fungsi anggota: OnFileSendMail dan OnUpdateFileSendMail.

MAPI perlu membaca file untuk mengirim lampiran. Jika aplikasi tetap membuka file datanya selama OnFileSendMail panggilan fungsi, file perlu dibuka dengan mode berbagi yang memungkinkan beberapa proses untuk mengakses file.

Untuk menerapkan perintah Kirim Email dengan MFC

1. Gunakan editor menu Visual C++ untuk menambahkan item menu yang ID perintahnya ID_FILE_SEND_MAIL.

   ID perintah ini disediakan oleh kerangka kerja di AFXRES.H. Perintah dapat ditambahkan ke menu apa pun, tetapi biasanya ditambahkan ke menu File .

2. Tambahkan yang berikut ini secara manual ke peta pesan dokumen Anda:

   ON_COMMAND(ID_FILE_SENDMAIL, &CMyDoc::OnFileSendMail)
   ON_UPDATE_COMMAND_UI(ID_FILE_SENDMAIL, &CMyDoc::OnUpdateFileSendMail)
   

   Catatan

   Peta pesan ini berfungsi untuk dokumen yang berasal dari CDocument atau COleDocument — ini mengambil kelas dasar yang benar dalam kedua kasus, meskipun peta pesan berada di kelas dokumen turunan Anda.

3. Bangun aplikasi Anda.

Jika dukungan email tersedia, MFC memungkinkan item menu Anda dengan OnUpdateFileSendMail dan kemudian memproses perintah dengan OnFileSendMail. Jika dukungan email tidak tersedia, MFC secara otomatis menghapus item menu Anda sehingga pengguna tidak akan melihatnya.

Untuk informasi terkait, lihat gambaran umum MAPI .

Untuk informasi selengkapnya tentang CDocument fungsi anggota yang mengaktifkan MAPI, lihat:

• CDocument::OnFileSendMail

• CDocument::OnUpdateFileSendMail

• COleDocument::OnFileSendMail

Baca juga

MAPI