Delphi DLL

Clear an Email Object

Demonstrates the Chilkat Email.Clear method, which removes the current message content — recipients, headers, body representations, attachments, related items, and embedded messages — leaving an empty email object. This example builds a message with a recipient and attachment, clears it, and prints the counts before and after.

Background: Reusing a single Email object across many operations is efficient, but leftover state from a previous message could leak into the next. Clear resets the object completely, giving you a clean slate — the safe way to start a fresh message without allocating a new object.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
email: HCkEmail;

begin
//  Demonstrates the Clear method, which removes the current message content, including
//  recipients, headers, body representations, attachments, related items, and embedded
//  messages -- leaving an empty email object.

email := CkEmail_Create();
CkEmail_putSubject(email,'A message');
CkEmail_putBody(email,'Some body text.');
CkEmail_AddTo(email,'Bob','bob@example.com');
CkEmail_AddStringAttachment(email,'notes.txt','Some notes.');

Memo1.Lines.Add('NumTo before clear = ' + IntToStr(CkEmail_getNumTo(email)));
Memo1.Lines.Add('NumAttachments before clear = ' + IntToStr(CkEmail_getNumAttachments(email)));

//  Remove all content, resetting the email object.
CkEmail_Clear(email);

Memo1.Lines.Add('NumTo after clear = ' + IntToStr(CkEmail_getNumTo(email)));
Memo1.Lines.Add('NumAttachments after clear = ' + IntToStr(CkEmail_getNumAttachments(email)));

CkEmail_Dispose(email);