Sample Application

SFVersaMail is a SatForms plug-in extension that enables you to send email messages using VersaMail. You can deposit a message into the VersaMail outbox, with the recipients, subject, and body text filled in, and optionally attach a file to the message as well.

The V1.1 release addresses compatibility issues with VersaMail 3.x that is included on several newer Palm devices, including the Treo 650, Treo700p, LifeDrive, and TX.

When you use the SendVersaMail method, a new outgoing email message is created, with the To, CC, BCC, Subject, and message Body fields filled in with the information you passed in to the extension. This message is silently deposited into the VersaMail Outbox, where it will be sent the next time you send and receive mail in VersaMail. This function is supported up to VersaMail version 2.7.1.

When you use the SendVersaMailWithFile method, a new outgoing email message is created, with the To, CC, BCC, Subject, and message Body fields filled in with the information you passed in to the extension, and the specified file is attached to the email. This message with file attachment is silently deposited into the VersaMail Outbox, where it will be sent the next time you send and receive mail in VersaMail. This function is supported up to VersaMail version 2.7.1.

A SendFileByMail function is also included. It allows you to specify a file to send as an attachment, then brings up an email compose form where you manually fill in the recipient address and subject. This function can be used on PalmOS 4.0 and higher devices, and can also be used with SnapperMail instead of VersaMail.

NOTE: SFVersaMail supports the sending of attached files in their native document formats, so the recipient does not need to do any file conversions to use the files. For example, text files created with SFTextFile arrive as regular text files in the recipient's email. JPG photos attached to an email arrive as standard JPG images, SFInkView BMP files arrive as regular BMPs, etc. Palm PRC and PDB databases can also be sent as attachments, of course.

The SendVersaMailHelper function (new in V1.1) creates an outgoing email in VersaMail and switches to the mail compose screen in VersaMail where the user can edit the message and then must tap on the Send, Outbox, Drafts, or Cancel button to complete the process. The user must then manually restart your application. This function is supported in VersaMail 3.0 and higher.

SFVersaMail supports Palm VersaMail 2.0 and higher. Due to a limitation of VersaMail, file attachments cannot exceed 60KB in size with the SendVersaMailWithFile function.

DocID: 10039  DocDate: 2006-10-02