PowerBuilder

Clear the To Recipients of an Email

Demonstrates the Chilkat Email.ClearTo method, which clears the list of direct (To) recipients. It changes only the current in-memory email object and does not affect messages already sent. This example adds two To recipients, clears them, and prints the count before and after.

Background: The To list holds a message's primary recipients. When reusing one Email object as a template across multiple sends, ClearTo wipes just that list so each send addresses the right people, without disturbing the subject, body, or attachments. It pairs with ClearCC and ClearBcc for full control over the recipient lists.

Chilkat PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email

//  Demonstrates the ClearTo method, which clears the list of direct (To) recipients.
//  This changes only the current email object.

loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")
if li_rc < 0 then
    destroy loo_Email
    MessageBox("Error","Connecting to COM object failed")
    return
end if

loo_Email.AddTo("Joe","joe@example.com")
loo_Email.AddTo("Jane","jane@example.com")
Write-Debug "NumTo before clear = " + string(loo_Email.NumTo)

//  Remove all To recipients.
loo_Email.ClearTo()

Write-Debug "NumTo after clear = " + string(loo_Email.NumTo)


destroy loo_Email