PowerBuilder

Save a Related Item to Disk

Demonstrates the Chilkat Email.SaveRelatedItem method, which saves the related item at a given zero-based index to a directory. If the directory or any of its components do not exist, Chilkat creates them. This example adds a related style sheet and saves it.

Background: Related items are the inline resources (images, style sheets) an HTML email carries in its multipart/related enclosure. SaveRelatedItem writes one of them out as a file — a building block for tasks like extracting a specific embedded image, or manually unpacking a message when you want finer control than the all-in-one UnpackHtml / AspUnpack methods provide.

Chilkat PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
integer li_Success
oleobject loo_Email

li_Success = 0

//  Demonstrates the SaveRelatedItem method, which saves the related item at a given
//  zero-based index to a directory.  If the directory (or any of its components) does not
//  exist, Chilkat creates it.

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 = "Save a related item"

//  Set an HTML body that references a related style sheet by name.
loo_Email.SetHtmlBody("<html><head><link rel=~"stylesheet~" href=~"styles.css~"/></head><body>Styled.</body></html>")
loo_Email.AddRelatedString2("styles.css","body { color: navy; }","utf-8")

//  Save the related item at index 0 into the specified directory.
li_Success = loo_Email.SaveRelatedItem(0,"qa_output/related")
if li_Success = 0 then
    Write-Debug loo_Email.LastErrorText
    destroy loo_Email
    return
end if

Write-Debug "Saved related item 0."

//  Note: The path "qa_output/..." is a relative local filesystem path,
//  relative to the current working directory of the running application.


destroy loo_Email