Udostępnij za pośrednictwem


Obsługa MAPI w MFC

Obsługa podzbioru z Microsoft Program interfejsu MAPI (Messaging Application) w klasie dostarcza MFC CDocument.W szczególności CDocument ma funkcji elementów członkowskich, które określają, czy obsługa poczty jest obecny na komputerze użytkownika końcowego i, jeśli tak jest, Włącz polecenia Wyślij pocztę, którego identyfikator standardowego polecenia jest ID_FILE_SEND_MAIL.Funkcja MFC obsługi tego polecenia zezwala użytkownikowi na wysyłanie dokumentu pocztą elektroniczną.

PoradaPorada

Chociaż MFC nie umieszczać cały zestaw funkcji MAPI, możesz zadzwonić funkcji MAPI bezpośrednio, tak jak można wywoływać funkcji Win32 API bezpośrednio z aplikacji MFC.

Dostarczanie poczty Wyślij polecenia w aplikacji jest bardzo proste.MFC zawiera implementacji dokumentu pakietu (czyli CDocument-pochodnych obiektu) jako załącznik i wysłać go jako poczta.Ten załącznik jest odpowiednikiem polecenia Zapisz plik, który zapisuje (szereguje) zawartości dokumentu do wiadomości pocztowej.Ta implementacja wzywa klienta poczty na komputer użytkownika daje użytkownikowi możliwość adresu poczty i dodać temat i tekst wiadomości do wiadomości pocztowej.Użytkownicy widzą ich znanych poczty interfejsu użytkownika.Ta funkcjonalność jest dostarczany przez dwa CDocument funkcje składowe: OnFileSendMail i OnUpdateFileSendMail.

MAPI musi odczytać plik do wysłania załącznika.Jeśli aplikacja utrzymuje własny plik danych otwarte podczas OnFileSendMail wywołanie funkcji, plik musi być otwarty z trybu udział, który umożliwia wielu procesów dostępu do tego pliku.

[!UWAGA]

Przesłanianie wersja OnFileSendMail dla klasy COleDocument poprawnie obsługuje złożone dokumenty.

Do wykonania polecenia Wyślij pocztę z MFC

  1. Za pomocą Edytora menu języka Visual C++ można dodać element menu, którego identyfikator polecenia jest ID_FILE_SEND_MAIL.

    Ten identyfikator polecenia jest dostarczana przez RAM w AFXRES.H.Polecenia mogą być dodawane do każdego menu, ale zwykle jest on dodawany do pliku menu.

  2. Do mapy wiadomości w dokumencie, należy ręcznie dodać następujący:

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

    [!UWAGA]

    Ta mapa wiadomość działa dla dokumentu pochodzący od którejkolwiek CDocument lub COleDocument — to podnosi prawidłową klasę podstawową w każdym przypadku, nawet jeśli mapę wiadomość jest w klasie pochodnej dokumentu.

  3. Budowanie aplikacji.

Jeśli obsługa poczty jest dostępne, MFC umożliwia elementu menu z OnUpdateFileSendMail i przetwarza następnie polecenia z OnFileSendMail.Jeśli obsługa poczty nie jest dostępny, MFC automatycznie usuwa elementu menu, więc użytkownik nie zobaczy go.

PoradaPorada

Zamiast ręcznie dodawać wpisów map wiadomość opisanej wcześniej, na którą należy mapować funkcji wiadomości może służyć okno właściwości klasy.Aby uzyskać więcej informacji, zobacz Mapowania wiadomości do funkcji.

Aby uzyskać pokrewne informacje, zobacz MAPI omówienie.

Aby uzyskać więcej informacji o CDocument funkcji elementów członkowskich, które umożliwiają MAPI, zobacz:

Zobacz też

Koncepcje

MAPI