(MFC) Explaining the Email FromName, FromAddress, and From Properties

This example explains the email object's FromName, FromAddress, and From properties.

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkEmail.h>

void ChilkatSample(void)
    {
    CkString strOut;

    // The email's FROM name and address can be set in several ways.
    // It can include an optional friendly name (which is just a description),
    // and it must include an address.

    // For example:
    CkEmail email1;
    email1.put_Subject("test");
    email1.put_Body("test");

    email1.put_FromName("Joe Sample");
    email1.put_FromAddress("joe.sample@example.com");

    // the From property contains both the FromName and FromAddress
    // This produces the following output:
    // From: "Joe Sample" <joe.sample@example.com>
    strOut.append("From: ");
    strOut.append(email1.ck_from());
    strOut.append("\r\n");
    strOut.append("--------------------------------------------------");
    strOut.append("\r\n");

    // Examine the MIME of the email:
    strOut.append(email1.getMime());
    strOut.append("\r\n");
    strOut.append("--------------------------------------------------");
    strOut.append("\r\n");

    // Output is:

    // 	MIME-Version: 1.0
    // 	Date: Wed, 16 Nov 2016 12:32:13 -0600
    // 	Message-ID: <02B461C6D12FA6686C3151A649ED8D5BBFBE0721@CHILKAT13>
    // 	Content-Type: text/plain
    // 	Content-Transfer-Encoding: 7bit
    // 	X-Priority: 3 (Normal)
    // 	Subject: test
    // 	From: "Joe Sample" <joe.sample@example.com>
    // 	CKX-Bounce-Address: joe.sample@example.com
    // 
    // 	test

    // --------------------------------------------
    // Alternatively, the From property can be set, and this 
    // implicitly sets the FromName and FromAddress properties.

    CkEmail email2;
    email2.put_From("Joe Sample <joe.sample@example.com>");

    strOut.append("FromName: ");
    strOut.append(email2.fromName());
    strOut.append("\r\n");
    strOut.append("FromAddress: ");
    strOut.append(email2.fromAddress());
    strOut.append("\r\n");
    strOut.append("--------------------------------------------------");
    strOut.append("\r\n");

    strOut.append(email2.getMime());
    strOut.append("\r\n");


    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }