Delphi DLL

Get a To Recipient's Name Only

Demonstrates the Chilkat Email.GetToName method, which returns only the friendly-name part (not the address) of the Nth To recipient. The index is zero-based. This example adds two To recipients and prints each one's display name.

Background: The display name is the human-friendly label attached to an address, like Joe Smith for joe@example.com. It is optional and purely cosmetic but useful for presentation. GetToName returns just that name; if a recipient was added without one, the result is empty, in which case fall back to GetToAddr.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
email: HCkEmail;
n: Integer;
i: Integer;

begin
//  Demonstrates the GetToName method, which returns only the friendly-name part (not the
//  address) of the Nth To recipient.  The index is zero-based.

email := CkEmail_Create();
CkEmail_putSubject(email,'GetToName example');

CkEmail_AddTo(email,'Joe Smith','joe@example.com');
CkEmail_AddTo(email,'Jane Doe','jane@example.com');

n := CkEmail_getNumTo(email);

for i := 0 to n - 1 do
  begin
    Memo1.Lines.Add('To ' + IntToStr(i) + ' name: ' + CkEmail__getToName(email,i));
  end;

CkEmail_Dispose(email);