Pascal (Lazarus/Delphi)

Mark IMAP Email as Read/Unread (Seen/Unseen)

Demonstrates how to mark emails as read or unread. 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.Imap,
  Chilkat.Email;

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

procedure RunDemo;
var
  success: Boolean;
  imap: TImap;
  numMsgs: Integer;
  email: TEmail;
  i: Integer;
  bIsUid: Boolean;

begin
  success := False;

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

  imap := TImap.Create;

  //  Connect to an IMAP server.
  //  Use TLS
  imap.Ssl := True;
  imap.Port := 993;
  success := imap.Connect('imap.example.com');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Login
  success := imap.Login('myLogin','myPassword');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Select an IMAP mailbox
  success := imap.SelectMailbox('Inbox');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Set PeekMode so that downloaded messages are not
  //  automatically marked as seen.
  imap.PeekMode := True;

  //  The NumMessages property contains the number of messages 
  //  in the currently selected mailbox.
  numMsgs := imap.NumMessages;
  if (numMsgs = 0) then
    begin
      Exit;
    end;

  email := TEmail.Create;

  for i := 1 to numMsgs do
    begin
      //  Download each email by sequence number (not UID)
      success := imap.FetchEmail(False,i,False,email);
      if (success = False) then
        begin
          WriteLn(imap.LastErrorText);
          Exit;
        end;

      //  If desired, mark the email as SEEN.  There are two
      //  ways to do it:

      //  1) Set the flag directly by using the sequence number
      //  Indicate that we are passing a sequence number and
      //  not a UID:
      bIsUid := False;
      //  Set the SEEN flag = 1 to mark the email as SEEN,
      //  or set it to 0 to mark it as not-seen.
      success := imap.SetFlag(i,bIsUid,'SEEN',1);
      if (success = False) then
        begin
          WriteLn(imap.LastErrorText);
          Exit;
        end;

      //  2) Alternatively, we can use the email object.
      //  When an email is downloaded from the IMAP server
      //  Chilkat will add a "ckx-imap-uid" header to the email.
      //  This makes it possible to know the UID associated with
      //  the email.  (This is not the sequence number, which may change
      //  from session to session, but the UID which does not change.
      //  The SetMailFlag method is identical to SetFlag, except
      //  it gets the UID from the ckx-imap-uid header.
      //  For example:
      success := imap.SetMailFlag(email,'SEEN',1);
      if (success = False) then
        begin
          WriteLn(imap.LastErrorText);
          Exit;
        end;

    end;

  //  Disconnect from the IMAP server.
  success := imap.Disconnect();


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