PureBasic

Convert a MIME Entity to multipart/alternative

Demonstrates the Chilkat Mime.ConvertToMultipartAlt method, which wraps the current entity in a new outer multipart/alternative, making the original the first child. It takes no arguments.

Note: The file paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: Use this to add an alternate rendering to an existing message — for example, promoting a plain-text message so an HTML version can be added alongside it. The original content becomes the first (least-preferred) alternative, and you append the richer representation after it. As with the mixed conversion, message-level headers move to the new outer entity.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkMime.pb"

Procedure ChilkatExample()

    success.i = 0

    mime.i = CkMime::ckCreate()
    If mime.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkMime::ckLoadMimeFile(mime,"qa_data/message.eml")
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        ProcedureReturn
    EndIf

    ;  Wrap the current entity in a new outer multipart/alternative entity.  The original entity
    ;  becomes the first child, ready for an alternate representation to be added.
    success = CkMime::ckConvertToMultipartAlt(mime)
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        ProcedureReturn
    EndIf

    ;  Add an alternative representation of the same content.
    htmlPart.i = CkMime::ckCreate()
    If htmlPart.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkMime::ckSetBodyFromHtml(htmlPart,"<html><body>HTML alternative.</body></html>")
    If success = 0
        Debug CkMime::ckLastErrorText(htmlPart)
        CkMime::ckDispose(mime)
        CkMime::ckDispose(htmlPart)
        ProcedureReturn
    EndIf

    success = CkMime::ckAppendPart(mime,htmlPart)
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        CkMime::ckDispose(htmlPart)
        ProcedureReturn
    EndIf

    Debug "Number of parts: " + Str(CkMime::ckNumParts(mime))


    CkMime::ckDispose(mime)
    CkMime::ckDispose(htmlPart)


    ProcedureReturn
EndProcedure