Sample code for 30+ languages & platforms
Delphi ActiveX

Get a Mail-Merge Replacement String by Pattern

See more Email Object Examples

Demonstrates the Chilkat Email.GetReplaceString2 method, which returns the replacement string for a previously-defined pattern/replacement pair, looked up by the pattern itself (a mail-merge feature). This example defines two pairs and looks up the replacement for one pattern by name.

Background: Where GetReplaceString fetches a replacement by its numeric position, GetReplaceString2 fetches it by the pattern — convenient when you already know the token (say FIRST_NAME) and just want its configured substitution without scanning the whole list.

Chilkat Delphi ActiveX Downloads

Delphi ActiveX
var
email: TChilkatEmail;
repl: WideString;

begin
//  Demonstrates the GetReplaceString2 method, which returns the replacement string for a
//  previously-defined pattern/replacement pair, looked up by the pattern itself (a
//  mail-merge feature).

email := TChilkatEmail.Create(Self);
email.Subject := 'Hello FIRST_NAME';
email.Body := 'Dear FIRST_NAME, welcome to CITY.';

email.SetReplacePattern('FIRST_NAME','John');
email.SetReplacePattern('CITY','Denver');

//  Look up the replacement for a specific pattern.
repl := email.GetReplaceString2('FIRST_NAME');
Memo1.Lines.Add('FIRST_NAME -> ' + repl);