Pascal (Lazarus/Delphi)

Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.MailMan,
  Chilkat.Email;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  mailman: TMailMan;
  email: TEmail;
  contentType: string;

begin
  success := False;

  //  This example requires the Chilkat API to have been previously unlocked.
  //  See Global Unlock Sample for sample code.

  mailman := TMailMan.Create;

  mailman.SmtpHost := 'smtp.my-mail-server.com';
  mailman.SmtpUsername := 'MY_SMTP_USERNAME';
  mailman.SmtpPassword := 'MY_SMTP_PASSWORD';
  mailman.SmtpSsl := True;
  mailman.SmtpPort := 465;

  email := TEmail.Create;

  email.Subject := 'This is a test';
  email.Body := 'This is a test';
  email.From := 'Chilkat Support <support@chilkatsoft.com>';
  success := email.AddTo('Chilkat Admin','admin@chilkatsoft.com');
  //  To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

  //  Add some attachments.
  //  The AddFileAttachment method returns the value of the content-type it chose for the attachment.
  contentType := email.AddFileAttachment('qa_data/jpg/starfish.jpg');
  if (email.LastMethodSuccess <> True) then
    begin
      WriteLn(email.LastErrorText);
      Exit;
    end;
  contentType := email.AddFileAttachment('qa_data/pdf/fishing.pdf');
  if (email.LastMethodSuccess <> True) then
    begin
      WriteLn(email.LastErrorText);
      Exit;
    end;

  //  If we save the email to a .eml, we can examine in a text editor.
  success := email.SaveEml('qa_output/e1.eml');
  if (success = False) then
    begin
      WriteLn(email.LastErrorText);
      WriteLn('Failed to save .eml');
      Exit;
    end;

  //  We see the following in the e1.eml
  //  Notice that Chilkat replaced the full path with just the filename.
  //  The full local path is not part of the email that gets sent..

  //  ...
  //  --------------020807050607070004010609
  //  Content-Type: image/jpeg; name="starfish.jpg"
  //  Content-Transfer-Encoding: base64
  //  Content-Disposition: attachment; filename="starfish.jpg"
  //  
  //  ...
  //  --------------020807050607070004010609
  //  Content-Type: application/pdf; name="fishing.pdf"
  //  Content-Transfer-Encoding: base64
  //  Content-Disposition: attachment; filename="fishing.pdf"
  //  ...

  //  Before sending, each filename can be changed within the email object.
  //  For example:
  success := email.SetAttachmentFilename(0,'orange_starfish.jpg');
  success := email.SetAttachmentFilename(1,'tuna_fishing.pdf');

  //  Look at the new MIME source of the email in a  text editor...
  success := email.SaveEml('qa_output/e2.eml');
  if (success = False) then
    begin
      WriteLn(email.LastErrorText);
      WriteLn('Failed to save .eml');
      Exit;
    end;

  //  You'll see this:

  //  ...
  //  --------------020807050607070004010609
  //  Content-Type: image/jpeg; name="orange_starfish.jpg"
  //  Content-Transfer-Encoding: base64
  //  Content-Disposition: attachment; filename="orange_starfish.jpg"
  //  
  //  ...
  //  --------------020807050607070004010609
  //  Content-Type: application/pdf; name="tuna_fishing.pdf"
  //  Content-Transfer-Encoding: base64
  //  Content-Disposition: attachment; filename="tuna_fishing.pdf"
  //  ...

  //  Send the email with the updated filenames..
  success := mailman.SendEmail(email);
  if (success <> True) then
    begin
      WriteLn(mailman.LastErrorText);
      Exit;
    end;

  success := mailman.CloseSmtpConnection();
  if (success <> True) then
    begin
      WriteLn('Connection to SMTP server not closed cleanly.');
    end;

  WriteLn('Mail with attachments sent!');


  mailman.Free;
  email.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.