PowerBuilder

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 PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email
string ls_Fname

//  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.

loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")
if li_rc < 0 then
    destroy loo_Email
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Email.Subject = "GetRelatedFilename example"

//  The HTML references a related style sheet by name (Content-Location).
loo_Email.SetHtmlBody("<html><head><link rel=~"stylesheet~" href=~"styles.css~"/></head><body>Styled.</body></html>")

//  Add the related style sheet (index 0).
loo_Email.AddRelatedString2("styles.css","body { color: navy; }","utf-8")

//  Read the filename of the first related item (index 0).
ls_Fname = loo_Email.GetRelatedFilename(0)
Write-Debug "Related item 0 filename: " + ls_Fname


destroy loo_Email