B4X Requires Chilkat v11.0.0+
B4X
Forward an Email using CreateForward
See more Email Object Examples
Reads an email from an IMAP server, creates a forward version of the email using the CreateForward method, and sends the email to another recipient.Chilkat B4X Downloads
Dim success As Boolean = False
' This example requires the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.
' Read the 1st (most recent) email in an Inbox.
Dim imap As ChilkatImap
imap.Initialize("imap")
' Connect to an IMAP server.
imap.Ssl = True
imap.Port = 993
success = imap.Connect("imap.example.com")
If success = False Then
Log(imap.LastErrorText)
Return
End If
' Login
success = imap.Login("myLogin", "myPassword")
If success = False Then
Log(imap.LastErrorText)
Return
End If
' Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
If success = False Then
Log(imap.LastErrorText)
Return
End If
Dim numEmails As Int = imap.NumMessages
' Fetch the email at the last sequence number.
' (We are assuming the Inbox has at least 1 email)
Dim email As ChilkatEmail
email.Initialize
success = imap.FetchEmail(False, numEmails, False, email)
If success = False Then
Log(imap.LastErrorText)
Return
End If
' Disconnect from the IMAP server.
imap.Disconnect
Log(email.Subject)
Dim eForward As ChilkatEmail
eForward.Initialize
success = email.ToForward(eForward)
If success = False Then
Log(email.LastErrorText)
Return
End If
' The eForward email has no To or CC recipients yet.
' Add one or more..
eForward.AddTo("Joe", "joe@example.com")
' We also need to specify the From name/address.
eForward.FromAddress = "matt@someMailServer.com"
eForward.FromName = "Matt"
' If we wish to add text at the start of the email body:
Dim sbHtmlBody As ChilkatStringBuilder
sbHtmlBody.Initialize
If eForward.HasHtmlBody = True Then
sbHtmlBody.Append(eForward.GetHtmlBody)
sbHtmlBody.Prepend("<p>Hello, this is an email I'm forwarding to you...</p>")
eForward.SetHtmlBody(sbHtmlBody.GetAsString)
End If
Dim sbPtBody As ChilkatStringBuilder
sbPtBody.Initialize
If eForward.HasPlainTextBody = True Then
sbPtBody.Append(eForward.GetPlainTextBody)
sbPtBody.Prepend("Hello, this is an email I'm forwarding to you..." & Chr(13) & Chr(10) & Chr(13) & Chr(10))
eForward.SetTextBody(sbPtBody.GetAsString, "text/plain")
End If
' We could save the .eml, then double-click on it to view in our mail program, such as Outlook or Thunderbird..
eForward.SaveEml("qa_output/forward.eml")
' We could send (forward) the email..
Dim mailman As ChilkatMailMan
mailman.Initialize("mailman")
mailman.SmtpHost = "smtp.example.com"
mailman.SmtpUsername = "myLogin"
mailman.SmtpPassword = "myPassword"
mailman.SmtpPort = 587
mailman.StartTLS = True
success = mailman.SendEmail(eForward)
If success = False Then
Log(mailman.LastErrorText)
Return
End If
success = mailman.CloseSmtpConnection
If success <> True Then
Log("Connection to SMTP server not closed cleanly.")
End If
Log("Mail Sent!")