Delphi DLL

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 Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
email: HCkEmail;

begin
success := 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.

email := CkEmail_Create();
CkEmail_putSubject(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.
success := CkEmail_SaveRelatedItem(email,0,'qa_output/related');
if (success = False) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Exit;
  end;

Memo1.Lines.Add('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.

CkEmail_Dispose(email);