Unicode C

Add an HTML Alternative Body to an Email

Demonstrates the Chilkat Email.AddHtmlAlternativeBody method, which adds an HTML alternative body. Combined with a plain-text body, it produces a multipart/alternative email that offers both representations of the same content. This example sets a plain-text body, adds an HTML alternative, and prints the resulting alternative count.

Background: A well-formed HTML email usually ships two versions of the body: a rich HTML version and a plain-text fallback, wrapped in a multipart/alternative container. The receiving client displays whichever it prefers — modern clients show the HTML, while text-only clients (or spam filters and accessibility tools) use the plain text. Providing both improves deliverability and ensures every recipient can read the message.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;

    //  Demonstrates the AddHtmlAlternativeBody method, which adds an HTML alternative body to
    //  the email.  Combined with a plain-text body, this produces a multipart/alternative
    //  email that offers both representations.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Plain-text and HTML alternatives");

    //  Start with a plain-text body.
    CkEmailW_SetTextBody(email,L"This is the plain-text version of the message.",L"text/plain");

    //  Add an HTML alternative, creating a multipart/alternative email.
    CkEmailW_AddHtmlAlternativeBody(email,L"<html><body><b>This is the HTML version.</b></body></html>");

    wprintf(L"NumAlternatives = %d\n",CkEmailW_getNumAlternatives(email));


    CkEmailW_Dispose(email);

    }