Compartilhar via


Suporte a MAPI no MFC

MFC fornece suporte para um subconjunto da Microsoft programa Interface MAPI (sistema de mensagens aplicativo) na classe CDocument.Especificamente, CDocument possui funções de membro que determinar se o suporte de correio está presente na computador do usuário participante e, em caso afirmativo, ativar um comando Enviar email cuja ID de comando padrão é ID_FILE_SEND_MAIL.A função de manipulador de MFC para este comando permite ao usuário enviar um documento por email.

Dica:

Embora o MFC não encapsula todo o conjunto de função MAPI, você ainda pode cal l MAPI funciona diretamente, assim sistema autônomo você pode chamar funções da API do Win32 diretamente do MFC programas.

Comando em seu aplicativo fornecendo enviar mensagem é muito fácil.MFC fornece a implementação de um documento (ou seja, um do pacoteCDocument - derivada objeto) sistema autônomo um anexo e enviá-la sistema autônomo email.Este anexo é equivalente a um comando arquivo salvar salva (serializa) o Sumário do documento para a mensagem de email.Essa implementação chama o cliente de email na computador do usuário para fornecer ao usuário a oportunidade de abordar o email e para adicionar texto de assunto e a mensagem a mensagem de correio.Os usuários vêem seus email familiar interface do usuário de aplicativo.Essa funcionalidade é fornecida por duas CDocument funções de membro: OnFileSendMail e OnUpdateFileSendMail.

MAPI precisa ler o arquivo para enviar o anexo.Se o aplicativo mantém o arquivo de dados abertas durante um OnFileSendMail telefonar de função, o arquivo precisa ser em aberto com um modo de compartilhamento que permite que vários processos acessar o arquivo.

Observação:

Uma versão de substituição OnFileSendMail para classe COleDocument corretamente alças compõem documentos.

Para implementar um comando Enviar email com MFC

  1. Use o editor de menu do Visual C++ para adicionar um item de menu cuja ID de comando é ID_FILE_SEND_MAIL.

    Essa ID de comando é fornecida pela estrutura no AFXRES.H.O comando pode ser adicionado a qualquer menu, mas geralmente ele é adicionado à Arquivo menu.

  2. Adicione manualmente o seguinte MAP da mensagem do seu documento:

    ON_COMMAND(ID_FILE_SENDMAIL, &CMyDoc::OnFileSendMail)
    ON_UPDATE_COMMAND_UI(ID_FILE_SENDMAIL, &CMyDoc::OnUpdateFileSendMail)
    
    Observação:

    Esse MAP de mensagens funciona para um documento derivado de um CDocument or COleDocument — ela pega a classe base correta em ambos os casos, mesmo que o MAP da mensagem esteja em sua classe derivada de documento.

  3. Crie seu aplicativo.

Se o suporte de email está disponível, MFC permite que o item de menu com OnUpdateFileSendMail e, em seguida, processa o comando com OnFileSendMail. Se suporte de email não estiver disponível, o MFC removerá automaticamente o item de menu para que o usuário não irá ver.

Dica:

Rat ela que manualmente adicionando entradas de MAP da mensagem sistema autônomo anteriormente descrito, você pode usar a janela Propriedades de classe para mapear mensagens para funções.Para obter mais informações, consulte Mapeamento de mensagens para funções.

Para obter informações relacionadas, consulte o MAPI visão geral.

Para obter mais informações sobre o CDocument funções de membro que permitem MAPI, consulte:

Consulte também

Conceitos

MAPI