Podpora MAPI v MFC
Knihovna MFC poskytuje podporu pro dílčí části Microsoft programu rozhraní MAPI (Messaging Application) ve třídě CDocument.Konkrétně CDocument má členské funkce, které určují, zda je v počítači koncového uživatele na podporu pošty a pokud ano, povolit příkaz Odeslat poštu, jejichž ID standardního příkazu je ID_FILE_SEND_MAIL.Obslužné rutiny knihovny MFC pro tento příkaz umožňuje uživateli odeslat dokument prostřednictvím elektronické pošty.
Tip
Ačkoli MFC zapouzdřují není celá sada funkcí rozhraní MAPI, stále funkce můžete volat rozhraní MAPI přímo, stejně jako můžete volat funkce rozhraní API systému Win32 přímo z aplikace knihovny MFC.
Odeslat poštu příkazu v aplikaci je velmi snadné.MFC poskytuje implementaci pro zabalení do dokumentu (to znamená, CDocument-odvozený objekt) jako přílohu a odeslat ji jako mail.Tato příloha je ekvivalentní příkaz Uložit soubor, který ukládá (serializuje) obsah dokumentu do e-mailové zprávě.Tato implementace volá po e-mailového klienta v počítači uživatele poskytuje uživateli možnost adresy e-mailu a e-mailové zprávy přidat předmět a text zprávy.Uvidí své známé poštovní aplikace uživatelského rozhraní.Tato funkce je dodávána ve dvou CDocument členské funkce: OnFileSendMail a OnUpdateFileSendMail.
MAPI je třeba číst soubor odešlete přílohu.Pokud aplikace udržuje otevřený během jeho datový soubor OnFileSendMail volání funkce, je třeba soubor otevřít v režimu sdílení, umožňující více procesů pro přístup k souboru.
[!POZNÁMKA]
Přepisující verzi OnFileSendMail pro třídu COleDocument správně zpracovává složené dokumenty.
K provedení příkazu Odeslat poštu s knihovnou MFC
Pomocí editoru Visual C++ nabídky přidat položku nabídky, jejichž ID příkazu je ID_FILE_SEND_MAIL.
Toto ID příkazu je poskytována rámci AFXRES.H.Příkaz lze přidat na jakoukoliv nabídku, ale obvykle je přidán do souboru nabídky.
Ručně přidejte do následující zprávy rozvržení:
ON_COMMAND(ID_FILE_SENDMAIL, &CMyDoc::OnFileSendMail) ON_UPDATE_COMMAND_UI(ID_FILE_SENDMAIL, &CMyDoc::OnUpdateFileSendMail)[!POZNÁMKA]
Mapa zpráva funguje pro dokument odvozeny buď z CDocument nebo COleDocument -ho zvedne správnou základní třídu v každém případě, i když mapu zpráv je ve třídě odvozené dokumentu.
Sestavte aplikaci.
Pokud je k dispozici podpora pošty, knihovny MFC umožňuje vaše položka nabídky s OnUpdateFileSendMail a následně zpracovává příkaz s OnFileSendMail.Pokud není k dispozici podpora pošty, MFC automaticky odebere nabídka tak uživatel neuvidí.
Tip
Namísto ruční přidávání položek mapování zpráv podle výše uvedených pokynů, můžete v okně Vlastnosti třídy mapování zpráv do funkcí.Další informace naleznete v tématu Mapování zpráv do funkcí.
Související informace naleznete rozhraní MAPI Přehled.
Další informace týkající CDocument členské funkce, které umožňují MAPI, viz: