B4X

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

Download Chilkat for B4X

B4X

Dim success As Boolean = False

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

Dim email As ChilkatEmail
email.Initialize
email.Subject = "Save a related item"

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

'  Save the related item at index 0 into the specified directory.
success = email.SaveRelatedItem(0, "qa_output/related")
If success = False Then
    Log(email.LastErrorText)
    Return
End If


Log("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.