(Delphi DLL) Determine the Number of Unseen Email Messages

Demonstrates how to determine how many unseen messages exist in an email account on an IMAP server.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Imap, MessageSet;

...

procedure TForm1.Button1Click(Sender: TObject);
var
imap: HCkImap;
success: Boolean;
totalNum: Integer;
fetchUids: Boolean;
messageSet: HCkMessageSet;
numUnseen: Integer;
i: Integer;
msgId: Integer;

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

imap := CkImap_Create();

// Connect to an IMAP server.
// Use TLS
CkImap_putSsl(imap,True);
CkImap_putPort(imap,993);
success := CkImap_Connect(imap,'imap.someMailServer.com');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

// Login
success := CkImap_Login(imap,'***','***');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

// Select an IMAP mailbox
success := CkImap_SelectMailbox(imap,'Inbox');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

// After selecting the mailbox. the total number of emails
// is immediately available:
totalNum := CkImap_getNumMessages(imap);
Memo1.Lines.Add('Num messages = ' + IntToStr(totalNum));

// To determine the number of unseen messages, a call
// to Search is required, which returns the set of UIDs
// of all unseen messages.

// We can choose to fetch UIDs or sequence numbers.
fetchUids := True;

messageSet := CkImap_Search(imap,'UNSEEN',fetchUids);
if (CkImap_getLastMethodSuccess(imap) = False) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

numUnseen := CkMessageSet_getCount(messageSet);
Memo1.Lines.Add(IntToStr(numUnseen));

Memo1.Lines.Add('UIDs ----');

// Display the UIDs
i := 0;

while i < CkMessageSet_getCount(messageSet) do
  begin
    msgId := CkMessageSet_GetId(messageSet,i);
    Memo1.Lines.Add(IntToStr(msgId));
    i := i + 1;
  end;

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

CkMessageSet_Dispose(messageSet);

CkImap_Dispose(imap);

end;