PowerBuilder

Count the To Recipients of an Email

Demonstrates the read-only Chilkat Email.NumTo property, which is the number of direct "To" recipients. To-recipient indexes are zero-based and can be inspected with GetTo, GetToAddr, and GetToName. This example adds three To recipients and prints the count.

Background: The To header lists the message's primary recipients — the people the email is directly addressed to and expected to act on it. A single email can have any number of To addresses, and each is stored as a display name plus an email address. Together with NumCC and NumBcc, this property lets you inspect the full recipient set of a message.

Chilkat PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email

//  Demonstrates the read-only Email.NumTo property, which is the number of direct
//  "To" recipients.  To-recipient indexes are zero-based.

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")
loo_Email.AddTo("Bob","bob@example.com")

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


destroy loo_Email