Xbase++

Change the Filename of an Attachment

Demonstrates the Chilkat Email.SetAttachmentFilename method, which changes the filename of the attachment at a given zero-based index. This example adds an attachment and renames it, printing the filename before and after.

Background: The attachment filename is what a recipient sees and what most clients suggest when saving the file. Renaming it is handy when the original name is unclear, unsafe, or generic — for example giving a machine-generated tmp12345 a meaningful name like invoice.pdf before sending.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oEmail

nSuccess := 0

//  Demonstrates the SetAttachmentFilename method, which changes the filename of the
//  attachment at the given zero-based index.

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "Set attachment filename"

oEmail:AddStringAttachment("oldname.txt", "Some notes.")
? "Filename before: " + oEmail:GetAttachmentFilename(0)

//  Change the filename of the first attachment (index 0).
nSuccess := oEmail:SetAttachmentFilename(0, "newname.txt")
IF (nSuccess == 0)
    ? oEmail:LastErrorText
    oEmail:destroy()
    RETURN
ENDIF

? "Filename after: " + oEmail:GetAttachmentFilename(0)

oEmail:destroy()