Pascal (Lazarus/Delphi)

Download and Save Email Attachments (POP3)

See more POP3 Examples

Downloads emails from a POP3 mailbox and saves all attachments. 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.EmailBundle,
  Chilkat.Email;

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

procedure RunDemo;
var
  success: Boolean;
  mailman: TMailMan;
  bundle: TEmailBundle;
  keepOnServer: Boolean;
  headersOnly: Boolean;
  numBodyLines: Integer;
  dirPath: string;
  email: TEmail;
  bundleIndex: Integer;
  numMessages: Integer;
  numAttachments: Integer;
  attachIndex: Integer;

begin
  success := False;

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

  //  The mailman object is used for receiving (POP3) 
  //  and sending (SMTP) email.
  mailman := TMailMan.Create;

  //  Set the POP3 server's hostname
  mailman.MailHost := 'pop.yourserver.com';

  //  Set the POP3 login/password.
  mailman.PopUsername := '***';
  mailman.PopPassword := '***';

  //  Copy the all email from the user's POP3 mailbox 
  //  into a bundle object.  The email remains on the server.
  //  FetchAll is a reasonable choice for POP3 maildrops that don't have too many
  //  emails. For larger mail drops, one might download emails one at a time..
  bundle := TEmailBundle.Create;
  keepOnServer := True;
  headersOnly := False;
  //  Irrelevent because we are NOT downloading headers-only
  numBodyLines := 0;
  success := mailman.FetchAll(keepOnServer,headersOnly,numBodyLines,bundle);
  if (success = False) then
    begin
      WriteLn(mailman.LastErrorText);
      Exit;
    end;

  //  The directory path can be relative or absolute.
  //  This shows a Windows style directory path.  On other operating systems, the path
  //  would be different..
  dirPath := 'c:/myAttachments';

  email := TEmail.Create;
  bundleIndex := 0;
  numMessages := bundle.MessageCount;

  while (bundleIndex < numMessages) do
    begin
      bundle.EmailAt(bundleIndex,email);

      //  Save all attachments to the specified directory.
      //  The directory is automatically created if it does not yet exist.
      success := email.SaveAllAttachments(dirPath);
      if (success = False) then
        begin
          WriteLn(email.LastErrorText);
          Exit;
        end;

      //  The OverwriteExisting property controls whether already-existing files
      //  are automatically overwritten.  By default, it is set to True so that existing
      //  files will be overwritten.

      //  Setting OverwriteExisting = False will cause the attachment-saving methods to generate
      //  unique filenames if a file with the same name already exists.  The actual filename(s)
      //  saved will be present by calling GetAttachmentFilename for each attachment *after*
      //  saving.
      //  For example...
      email.OverwriteExisting := False;
      success := email.SaveAllAttachments(dirPath);
      if (success = False) then
        begin
          WriteLn(email.LastErrorText);
          Exit;
        end;

      numAttachments := email.NumAttachments;
      attachIndex := 0;
      while (attachIndex < numAttachments) do
        begin
          //  If the attachment filename was changed to prevent overwriting,
          //  GetAttachmentFilename will return the new filename.
          WriteLn(email.GetAttachmentFilename(attachIndex));
          attachIndex := attachIndex + 1;
        end;

      //  Attachments can also be saved individually.
      attachIndex := 0;
      while (attachIndex < numAttachments) do
        begin

          WriteLn('Original Filename: ' + email.GetAttachmentFilename(attachIndex));
          success := email.SaveAttachedFile(attachIndex,dirPath);
          if (success = False) then
            begin
              WriteLn(email.LastErrorText);
              Exit;
            end;

          //  If OverwriteExisting = True, the saved filename will always equal the original filename,
          //  unless there are characters present in the filename that are not allowed by Windows,
          //  such as * ? < > | etc.  In those cases the illegal characters are either removed or replaced
          //  with underscore characters to allow the file to be saved.
          WriteLn('Saved Filename: ' + email.GetAttachmentFilename(attachIndex));
          attachIndex := attachIndex + 1;
        end;

      bundleIndex := bundleIndex + 1;
    end;



  mailman.Free;
  bundle.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.