Tcl

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

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

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

set email [new_CkEmail]

CkEmail_put_Subject $email "Set attachment filename"

CkEmail_AddStringAttachment $email "oldname.txt" "Some notes."
puts "Filename before: [CkEmail_getAttachmentFilename $email 0]"

#  Change the filename of the first attachment (index 0).
set success [CkEmail_SetAttachmentFilename $email 0 "newname.txt"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkEmail $email
    exit
}

puts "Filename after: [CkEmail_getAttachmentFilename $email 0]"

delete_CkEmail $email