Unicode C

Remove the Plain-Text Body from an Email

Demonstrates the Chilkat Email.RemovePlainTextAlternative method, which removes the plain-text body from the email if one exists. Other body representations, attachments, and related items remain unchanged. This example builds a message with both plain-text and HTML alternatives, then removes the plain text.

Background: This is the counterpart to RemoveHtmlAlternative. Removing the plain-text alternative leaves an HTML-only message. Note that dropping the plain-text fallback is generally discouraged for real mail — it hurts accessibility and can raise spam scores — but it is occasionally needed when a downstream system expects a single HTML representation.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;

    //  Demonstrates the RemovePlainTextAlternative method, which removes the plain-text body
    //  from the email (if one exists).  Other body representations, attachments, and related
    //  items remain.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Remove plain-text alternative");

    //  Create an email with both plain-text and HTML alternatives.
    CkEmailW_SetTextBody(email,L"This is the plain-text version.",L"text/plain");
    CkEmailW_AddHtmlAlternativeBody(email,L"<html><body>This is the HTML version.</body></html>");
    wprintf(L"NumAlternatives before = %d\n",CkEmailW_getNumAlternatives(email));
    wprintf(L"HasPlainTextBody before: %d\n",CkEmailW_HasPlainTextBody(email));

    //  Remove the plain-text body, leaving the HTML alternative.
    CkEmailW_RemovePlainTextAlternative(email);
    wprintf(L"NumAlternatives after = %d\n",CkEmailW_getNumAlternatives(email));
    wprintf(L"HasPlainTextBody after: %d\n",CkEmailW_HasPlainTextBody(email));


    CkEmailW_Dispose(email);

    }