DataFlex

Get the Filename of a Related Item

Demonstrates the Chilkat Email.GetRelatedFilename method, which returns the filename of a related item contained within the email. Related items are typically images and style sheets embedded within HTML emails, and the index is zero-based. This example adds a related style sheet and reads its filename.

Background: A related item's filename is how the HTML body refers to it — for example a style sheet named styles.css or an image named logo.png. When unpacking or archiving an HTML email, this filename is the natural name to write each embedded resource to on disk so the rewritten HTML links continue to resolve.

Chilkat DataFlex Downloads

Download Chilkat for DataFlex

DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoEmail
    String sFname

    //  Demonstrates the GetRelatedFilename method, which returns the filename of a related item
    //  contained within the email.  Related items are typically images and style sheets
    //  embedded within HTML emails.  The index is zero-based.

    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End
    Set ComSubject Of hoEmail To "GetRelatedFilename example"

    //  The HTML references a related style sheet by name (Content-Location).
    Send ComSetHtmlBody To hoEmail '<html><head><link rel="stylesheet" href="styles.css"/></head><body>Styled.</body></html>'

    //  Add the related style sheet (index 0).
    Send ComAddRelatedString2 To hoEmail "styles.css" "body { color: navy; }" "utf-8"

    //  Read the filename of the first related item (index 0).
    Get ComGetRelatedFilename Of hoEmail 0 To sFname
    Showln "Related item 0 filename: " sFname


End_Procedure