DataFlex

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

Download Chilkat for DataFlex

DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoEmail
    Boolean iSuccess
    Integer n
    Integer i
    String sTemp1

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

    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End
    Set ComSubject Of hoEmail To "GetToName example"

    Get ComAddTo Of hoEmail "Joe Smith" "joe@example.com" To iSuccess
    Get ComAddTo Of hoEmail "Jane Doe" "jane@example.com" To iSuccess

    Get ComNumTo Of hoEmail To n

    For i From 0 To (n - 1)
        Get ComGetToName Of hoEmail i To sTemp1
        Showln "To " i " name: " sTemp1
    Loop



End_Procedure