MAPI-Unterstützung in MFC
MFC-Zubehör Unterstützung für eine Teilmenge der Microsoft-Messaging-Anwendungsprogrammierschnittstelle (MAPI) in der Klasse CDocument.Insbesondere verfügt CDocument-Memberfunktionen, die bestimmen, ob E-Mail-Unterstützung auf dem Computer des Endbenutzers vorhanden ist und ggf. einen sendens-E-Mail-Befehl aktiviert, dessen Standardwert befehls-id ID_FILE_SEND_MAIL ist.Die MFC-Handlerfunktion für diesen Befehl kann der Benutzer ein Dokument per E-Mail zu senden.
.gif "Tipp") Tipp |
|---|
Obwohl MFC nicht den gesamten MAPI-Funktions Gruppe kapselt, können Sie MAPI-Funktionen, als Sie es direkt aufrufen können Win32 API-Funktionen von MFC-Programmen direkt aufrufen. |
Der sendens-E-Mail-Befehl in der Anwendung bereitzustellen ist sehr einfach.MFC stellt die Implementierung für das Paket ein Dokument (d. h. CDocument abgeleitetes Objekt) als Anlage an und sendet sie als E-Mail-Nachricht.Diese Installation ist für einen Befehl Datei-Abwehr (serialisiert), der entsprechend dem Inhalt des Dokuments an die E-Mail-Nachricht speichert.Diese Implementierung erfordert den E-Mail-Clients auf dem Computer des Benutzers auf, um dem Benutzer die Möglichkeit zu geben, die E-Mail-Nachricht zu begegnen und Betreff- und Meldungstext der E-Mail-Nachricht hinzugefügt werden soll.Benutzer werden die Benutzeroberfläche der vertrauten E-Mail-Anwendung.Diese Funktionalität wird durch zwei CDocument-Memberfunktionen angegeben: OnFileSendMail und OnUpdateFileSendMail.
MAPI muss die Datei lesen, um die Anlage zu senden.Wenn die Anwendung eine Datendatei während eines Funktionsaufrufs führt OnFileSendMail geöffnet, muss die Datei mit dem Freigeben Modus geöffnet werden, der ermöglicht, dass mehrere Prozesse die Datei zuzugreifen.
| Hinweis |
|---|
Eine überschreibende Version von OnFileSendMail für Verbunddokumente ordnungsgemäß behandelt COleDocument-Klasse. |
So fügen Sie einen sendens-E-Mail-Befehl mit MFC implementieren
Verwenden Sie den Visual C++-Menü Editor, um ein Menüelement hinzuzufügen, dessen Befehls-ID ID_FILE_SEND_MAIL ist.
Die Befehls-ID wird vom Framework an. AFXRES.H bereitgestellt.Der Befehl kann auf jeden Menü hinzugefügt werden, jedoch normalerweise dem Datei Menü hinzugefügt.
Fügen Sie manuell das nächste der Meldungszuordnung des Dokuments hinzu:
ON_COMMAND(ID_FILE_SENDMAIL, &CMyDoc::OnFileSendMail) ON_UPDATE_COMMAND_UI(ID_FILE_SENDMAIL, &CMyDoc::OnUpdateFileSendMail)HinweisDiese Meldungszuordnung funktioniert für ein Dokument, das entweder von CDocument oder COleDocument abgeleitet ist, sie werden die richtigen Basisklasse in jedem Fall auf, obwohl die Meldungszuordnung in der abgeleiteten Dokumentklasse ist.
Erstellen Sie die Anwendung.
Wenn E-Mail-Unterstützung verfügbar ist, ermöglicht das Menüelement mit MFC OnUpdateFileSendMail und verarbeitet anschließend den Befehl mit OnFileSendMail.Wenn E-Mail-Unterstützung nicht verfügbar ist, entfernt MFC automatisch das Menüelement, sodass der Benutzer nicht.
| Tipp |
|---|
Statt manuell hinzufügen, Meldungszuordnungs Dateisystemeinträgen, wie zuvor beschrieben, können Sie die Klasse Eigenschaftenfenster verwenden, um Nachrichten zu Funktionen zuordnen.Weitere Informationen finden Sie unter Zuordnung von Meldungen zu Funktionen. |
Weitere Informationen finden Sie in der MAPI Overview.
Weitere Informationen über die CDocument-Memberfunktionen, die MAPI aktivieren, finden Sie unter folgenden Themen: