TEmail Readme File

TEmail: MAPI component (V2.05.00)

Danny Heijl [URL]

Stefan Hoffmeister [URL]

TEmail is a non-visual component that allows you to send and receive e-mail on any Windows 3.x or Windows 95 or Windows NT PC that has MAPI-compatible e-mail provider software installed.
MAPI is an acronym for Microsoft's "Messaging Application Programming Interface".
MS-Mail and MS-Exchange client software, and Novell Groupwise client software are examples of MAPI providers.
They all supply "simple MAPI services" via MAPI(32).DLL.

If MAPI support has not been installed, and you will not be able to use TEmail! The component will also test the availability of MAPI at runtime.

You can develop without MAPI support though.

Installation Instructions
Component Description
History, Authors and Credits

1. Installation instructions :

1. Unzip Temail2.zip to a temporary directory

2. Copy compon\*.* to your component directory

3. Installation for

Delphi 1: install email16.pas into your component library and rebuild the component library.

email.kwf

email.hlp

Delphi 2: install email32.pas into your component library and rebuild the component library.

email.kwf

email.hlp

email.cnt

Delphi 3: either install email32.pas into one of your user-defined packages, or open (File | Open) email3.dpk and press install.

email.hlp

email.cnt

; TEmail Help

;------------

:Link email.hlp

4. From this moment on you can play with the standard demo application PMAPI.DPR in the ENHDEMO directory. The demo is source code compatible with every version of Delphi.

You may want to have a look at the FAXDEMO directory, which contains another demonstration of how to use the component with MAPI Fax support.

Alternatively you can play with the "TEmail" component itself.

2. Component Description :

Published properties (design-time) :

Acknowledge : Boolean : sendmail sets receipt requested
Attachment : TStrings with attachment file names
CC : TStrings with CC
BCC : TStrings with BCC
MAPIAvail : Boolean read-only flag tells if MAPI services are present.
Profile : the Exchange logon profile (or MSMAIL logon id) defaults to Exchange DefaultProfile from registry when running on a Win32 system
Password : the logon password
ShowDialog : lets you use the standard Mail clients editor
Recipient : TStrings with recipients
Subject : Pascal (short)string with subject
Text : Pascal (short)string with (short) message body text
UnreadOnly: Boolean : retrieves only new messages with GetNextMessageID
UseDefProfile : Boolean : lets you use the Exchange default profile (this also works for a 16bit application running on a 32bit Windows)
DownLoadFirst : Boolean : MAPI will first get new mail messages before returning from Logon if set to True. If left False, Logon will return immediately and new mail will be fetched in background.

Logon profile and password are not needed if you are already logged on.
If you are not logged on, you can leave them blank, a logon dialog box will pop up.

Public methods :

function SetLongText : PChar : sets pointer to long message text
function GetLongtext : PChar : gets pointer to long message text
function Logon : integer : mapi logon
function Logoff : integer : mapi logoff
function CheckRecipient : (short)string returns valid recipient
function CheckAttachment : (short)string returns valid attachment
function SendMail : integer : sends mail
function CountUnread : integer : counts unread messages
function GetNextMessageId: (short)string : gets next message id
function ReadMail : integer : reads a mail by message id
function Address : check all addresses in recipient stringlists allows user to add addresses with dialog box pop-up
function CopyAttachment(index, destination, deleteflag) : integer, copies a given attachment from it's temp location to a destination pathname optionally deleting the temporary copy.
procedure DownLoad : will get new mail by logging off, setting DownLoadFirst to True, and loggin on again.

Public properties (runtime) :

AttPathNames: TStrings with received attachment temp pathnames if NoAttachments was False on ReadMail.
DateRecvd : (short)string : date received (ReadMail)
HeaderOnly : boolean : ReadMail returns "envelope only"
LeaveUnread : boolean : ReadMail does not flag read messages "read"
MessageId : (short)string : message id for ReadMail and DeleteMail, returned by GetNextMessageId
Originator : (short)string : message originator (readmail)
OrigAddress : (short)string, mail address of originator
Unread : boolean : message was already marked "read" flag (ReadMail)
NoAttachments : boolean : ReadMail does not retrieve attachments If set False : attachments are copied to a temporary location, you get the temporary pathnames in the AttPathNames stringlist.

Take care : if you set NoAttachments to false, then readmail will put the attachments in a temp directory, and you have to delete them yourself, or call CopyAttachment with the delete_after_copy flag set to True!

3. History :

Original version 1.00.00 : Keith Darragh (c) SWIFTsoft 1995

Version 2.00.00, 2.00.0a, 2.00.0b : Danny Heijl :

Extended Keith's code sample to a fully functional MAPI component with demo application :

MAPI header file moved to a separate "smapi.pas" (simple mapi.pas)
adds Acknowledge property (acknowledge receipt)
adds CC property (multiple CCs in a stringlist)
adds support for multiple recipients (in a stringlist)
adds support for multiple attachments (in a stringlist)
adds SetLongText/GetLongText methods, in case your message happens to be > 255 bytes
adds CheckRecipient method
adds CheckAttachment method
adds GetNextMessageId method
adds ReadMail method
adds 'LeaveUnread' property for ReadMail
adds 'NoAttachments' property for ReadMail
adds 'HeaderOnly' property for ReadMail
adds support for DELPHI 2.0

Version 2.00.0c :

Rudi Claasen :

added MAPI "address" dialog

added BCC property
moved repeated code to an internal procedure "ListToRecipArray"

Danny Heijl :

added "profile" and "password" properties
added "UseDefProfile" property for WIN32 Exchange clients

Version 2.01.00 : Stefan Hoffmeister :

added "pass-thru addressing", ie: [FAX:123456] or [SMTP:xxx@yyy] bypassing the address book
implemented dynamic loading of the MAPI(32).DLL, raises exception if MAPI(32).DLL is not found
added "MAPIAvail" property (read-only)
implemented dynamic arrays for recipient/attachment arrays
some cosmetic changes

Version 2.02.00 : Stefan Hoffmeister :

enabled "UseDefProfile" property for 16bit applications running on a native 32bit systems (Win95, WinNT)

added a second attempt to load DLLs dynamically (for NT)
added property ShowDialog - use the standard MAPI editor for editing

Version 2.02.0a :

Ismail Esmail

runtime property "OrigAddress" added
Also: minor bugfix for Delphi 16 in the 2.02.00 code (Danny)

Version 2.03.00 :

Danny Heijl :

Changes to attachment code suggested by Roman Popov:

added runtime stringlist property with the pathnames of received attachments
the pathname of attachments is returned in the attachment property in case your MAPI implementation does not use the filename member of the mapimessage structure
a new method "CopyAttachment(stringlist_index, destination, deleteaftercopyflag)" copies an attachment for you.

Stefan Hoffmeister :

tested with Delphi 3, implemented resource strings.

Steve Pinneo :

A new enhanced "Demo App" , further enhanced by Stefan.

Version 2.04.00 :

Stefan Hoffmeister :

If UseDefProfile = true was used in a 16bit Windows environment, error messages would be shown, though the component would continue to work. This has been fixed.
Added property UnreadOnly as suggested by Nikolai Soumarokov - this will only retrieve unread mail.
Some changes to the help file and documentation.
Added FAX broadcast demo courtesy of Michael Wilcox. This application demonstrates how to amend a database of address details and fax a letter to people automatically using MS Exchange.

Version 2.05.00 :

Danny Heijl :

Implemented new property DownLoadFirst and new procedure Download on suggestion of Roman Popov
Updates to the documentation

If you have added features to this component feel free to send them and they will probably be incorporated into future releases to the benefit of everybody.

Last update : 22/06/97