PowerBuilder

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 PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email
integer n
integer i

//  Demonstrates the GetToName method, which returns only the friendly-name part (not the
//  address) of the Nth To recipient.  The index is 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.Subject = "GetToName example"

loo_Email.AddTo("Joe Smith","joe@example.com")
loo_Email.AddTo("Jane Doe","jane@example.com")

n = loo_Email.NumTo

for i = 0 to n - 1
    Write-Debug "To " + string(i) + " name: " + loo_Email.GetToName(i)
next


destroy loo_Email