Supporto MAPI in MFC

Supporto di fornisce MFC a un sottoinsieme dell'application program interface) di messaggistica Microsoft (MAPI) nella classe CDocument.In particolare, CDocument ha funzioni membro che determinano se il supporto di posta elettronica è presente nel computer degli utenti finali e, in caso affermativo, attivare un comando di posta elettronica di inviare il cui ID comando standard è ID_FILE_SEND_MAIL.La funzione di gestione MFC per questo comando consente all'utente incluso un documento tramite posta elettronica.

SuggerimentoSuggerimento

Sebbene MFC non incapsuli l'intero set di funzione MAPI, è comunque possibile chiamare direttamente le funzioni MAPI, proprio come si può chiamare le funzioni API Win32 direttamente dai programmi MFC.

Assegnare al comando di posta elettronica di inviare nell'applicazione è molto semplice.MFC fornisce l'implementazione per comprimere un documento (ovvero CDocumentoggetto derivato da) come allegato e di inviarlo come posta elettronica.Questo associato è equivalente a un comando di salvataggio file che salva (serializza) il contenuto del messaggio di posta elettronica.Questa implementazione rivolge al client di posta elettronica nel computer dell'utente per fornire all'utente la possibilità della destinazione posta elettronica e aggiungere l'oggetto e il testo del messaggio al messaggio di posta elettronica.Gli utenti visualizzano l'interfaccia utente comune dell'applicazione di posta elettronica.Questa funzionalità viene fornita da due funzioni membro di CDocument : OnFileSendMail e OnUpdateFileSendMail.

MAPI necessario leggere il file per inviare allegato.Se l'applicazione mantiene il relativo file di dati aperto durante la chiamata di funzione di OnFileSendMail , il file deve essere aperto con una modalità di condivisione che consente di più processi possono accedere al file.

[!NOTA]

Una versione di override di OnFileSendMail per classe COleDocument gestisce correttamente i documenti compositi.

Per implementare un messaggio di posta elettronica di inviare ordinare con MFC

  1. Utilizzare l'editor di menu di Visual C++ per aggiungere una voce di menu in cui l'ID di comando è ID_FILE_SEND_MAIL.

    Questo ID comando è fornito dal framework in AFXRES.H.Il comando può essere aggiunto a qualsiasi menu, ma in genere viene aggiunto al menu di File .

  2. Aggiungere manualmente quanto segue alla mappa messaggi del documento:

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

    [!NOTA]

    Funzionamento di questa mappa dei messaggi per un documento derivato da CDocument o da COleDocument — accetta la classe base corretta in entrambi i casi, anche se la mappa messaggi è presente nella classe derivata del documento.

  3. Compilare l'applicazione.

Se il supporto di posta elettronica è disponibile, MFC consente la voce di menu con OnUpdateFileSendMail e successivamente elabora il comando con OnFileSendMail.Se il supporto di posta elettronica non è disponibile, MFC rimuove automaticamente la voce di menu pertanto l'utente non si vedrà.

SuggerimentoSuggerimento

Anziché manualmente aggiungendo voci della mappa messaggi come descritte in precedenza, è possibile utilizzare la finestra delle proprietà della classe per eseguire il mapping dei messaggi e funzioni.Per ulteriori informazioni, vedere Mapping di messaggi a funzioni.

Per informazioni correlate, vedere i cenni preliminari su MAPI .

Per ulteriori informazioni sulle funzioni membro di CDocument che abilitano MAPI, vedere:

Vedere anche

Concetti

MAPI