Tcl

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

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

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

set email [new_CkEmail]

CkEmail_put_Subject $email "Save a related item"

#  Set an HTML body that references a related style sheet by name.
CkEmail_SetHtmlBody $email "<html><head><link rel=\"stylesheet\" href=\"styles.css\"/></head><body>Styled.</body></html>"
CkEmail_AddRelatedString2 $email "styles.css" "body { color: navy; }" "utf-8"

#  Save the related item at index 0 into the specified directory.
set success [CkEmail_SaveRelatedItem $email 0 "qa_output/related"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkEmail $email
    exit
}

puts "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.

delete_CkEmail $email