PowerBuilder

Set Uncommon Email Options

Demonstrates the Chilkat Email.UncommonOptions property, a catch-all for uncommon needs. It defaults to the empty string and should typically remain empty. Recognized keywords include NoBccHeader (do not add the Bcc MIME header for BCC addresses — which must be set before calling AddBcc or AddMultipleBcc) and NO_FORMAT_FLOWED (do not automatically add format=flowed to a Content-Type header). This example sets NoBccHeader.

Background: Long-lived libraries accumulate rare, situational tweaks that do not each deserve their own property. Chilkat gathers these into a single keyword-driven UncommonOptions string. NoBccHeader is a good example: normally a Bcc header is generated (and stripped at send time), but certain workflows want it omitted entirely. Only documented keywords have any effect — unrecognized text is ignored — so leave this empty unless a specific compatibility need arises.

Chilkat PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email

//  Demonstrates the Email.UncommonOptions property, a catch-all for uncommon needs.
//  It defaults to empty and should usually remain empty.  Recognized keywords include
//  "NoBccHeader" (do not add the Bcc MIME header) and "NO_FORMAT_FLOWED".

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 = "UncommonOptions example"
loo_Email.From = "alice@example.com"

//  Do not add the Bcc MIME header for BCC recipients.  This keyword must be set
//  before calling AddBcc or AddMultipleBcc.
loo_Email.UncommonOptions = "NoBccHeader"

loo_Email.AddBcc("Joe","joe@example.com")

Write-Debug "UncommonOptions = " + loo_Email.UncommonOptions


destroy loo_Email