Sdílet prostřednictvím


Podpora MAPI v MFC

MFC poskytuje podporu pro dílčí z 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 uživatele koncového podpora pošty a pokud ano, povolit příkaz Odeslat poštu ID standardní příkaz ID_FILE_SEND_MAIL.Funkci zpracování MFC pro tento příkaz umožňuje uživateli odeslat dokument elektronickou poštou.

Tip

Přestože MFC není zapouzdřit celou sadu funkcí rozhraní MAPI, můžete stále volat funkce rozhraní MAPI přímo, stejně jako můžete volat funkce rozhraní Win32 API přímo z aplikací MFC.

Odeslat poštu příkazu v aplikaci je velmi snadné.MFC umožňuje provádění balíček dokumentu (je CDocument-odvozené objekt) jako přílohu a odeslat jako poštu.Tuto přílohu je ekvivalentní příkazu Uložit soubor, který uloží (řadí) obsah dokumentu na poštovní zprávu.Tato implementace vyzývá e-mailového klienta v počítači uživatele poskytují příležitost poštovní adresu a předmět a text zprávy do e-mailové zprávy přidat uživatele.Uživatelé mohou zobrazit uživatelské rozhraní aplikace jejich známých pošty.Tato funkce je dodávána dvěma CDocument funkce členů: OnFileSendMail a OnUpdateFileSendMail.

MAPI musí přečíst soubor odešlete přílohu.Pokud aplikace udržuje během otevřít datový soubor OnFileSendMail volání funkce soubor musí být otevřen v režimu sdílení, umožňující přístup k souboru více procesů.

[!POZNÁMKA]

Převažující verzi OnFileSendMail pro třídu COleDocument správně zpracovává složené dokumenty.

K provedení příkazu Odeslat poštu s MFC

  1. V editoru jazyka Visual C++ nabídky přidat položku nabídky, jejichž ID příkazu je ID_FILE_SEND_MAIL.

    Toto ID příkazu poskytuje rámec v AFXRES.H.Příkaz lze přidat všechny nabídky, ale obvykle je přidán do soubor nabídce.

  2. Ručně přidejte následující zpráva 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 – ji zvedne správnou základní třídu, v každém případě, i když zpráva mapa je v dokumentu odvozené třídy.

  3. Sestavte aplikaci.

Pokud je k dispozici podpora pošty, MFC umožňuje položky nabídky s OnUpdateFileSendMail a následně zpracovává příkaz s OnFileSendMail.Pokud není k dispozici podpora pošty, MFC automaticky odebere položky nabídky tak, aby se uživateli nezobrazí.

Tip

Namísto přidání ručně výše popsané položky mapování zpráv, můžete okno Vlastnosti třídy mapovat funkce zpráv.Další informace naleznete v tématu Mapování zpráv do funkcí.

Související informace naleznete rozhraní MAPI Přehled.

Další informace o CDocument členské funkce, které umožňují MAPI, viz:

Viz také

Koncepty

ROZHRANÍ MAPI