(Visual FoxPro) Explaining the Email FromName, FromAddress, and From Properties

This example explains the email object's FromName, FromAddress, and From properties.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loEmail1
LOCAL loEmail2

* The email's FROM name and address can be set in several ways.
* It can include an optional friendly name (which is just a description),
* and it must include an address.

* For example:
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Email')
loEmail1 = CreateObject('Chilkat.Email')
loEmail1.Subject = "test"
loEmail1.Body = "test"

loEmail1.FromName = "Joe Sample"
loEmail1.FromAddress = "joe.sample@example.com"

* the From property contains both the FromName and FromAddress
* This produces the following output:
* From: "Joe Sample" <joe.sample@example.com>
? "From: " + loEmail1.From
? "--------------------------------------------------"

* Examine the MIME of the email:
? loEmail1.GetMime()
? "--------------------------------------------------"

* Output is:

* 	MIME-Version: 1.0
* 	Date: Wed, 16 Nov 2016 12:32:13 -0600
* 	Message-ID: <02B461C6D12FA6686C3151A649ED8D5BBFBE0721@CHILKAT13>
* 	Content-Type: text/plain
* 	Content-Transfer-Encoding: 7bit
* 	X-Priority: 3 (Normal)
* 	Subject: test
* 	From: "Joe Sample" <joe.sample@example.com>
* 	CKX-Bounce-Address: joe.sample@example.com
* 
* 	test

* --------------------------------------------
* Alternatively, the From property can be set, and this 
* implicitly sets the FromName and FromAddress properties.

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Email')
loEmail2 = CreateObject('Chilkat.Email')
loEmail2.From = "Joe Sample <joe.sample@example.com>"

? "FromName: " + loEmail2.FromName
? "FromAddress: " + loEmail2.FromAddress
? "--------------------------------------------------"

? loEmail2.GetMime()

RELEASE loEmail1
RELEASE loEmail2