E-mail是Internet/Intranet网上通信的最主要的方式之一,充分利用E-mail 的功能可以极大地提高企业的工作效率,减轻用户的工作负担。Windows 95中提供了一个名为Exchange的电子邮件客户程序,它包含了收件箱、发件箱、收发消息、消息优先级等功能,广泛支持超文本消息、收发传真和Internet邮件等内容,可以在LAN、Microsoft Fax、远程邮件、Internet等多种软件环境中工作。在VFP、VB开发的应用系统中结合Exchange的邮件服务功能,可以使您的应用系统功能更强大、服务更完善、使用更方便。下面介绍VB、VFP的MAPI控件以及在VB、VFP应用系统中使用这些控件收发E-mail的方法。 一.MAPI控件概述
MAPI(通信应用程序接口)控件,即MSMAPI32.OCX,包括两个OLE控件:MAPISession(MAPI工作期)控件和MAPIMessage(MAPI消息)控件。MAPISession控件的功能是负责建立会话、取消会话的一个MAPI工作期。MAPIMessage控件则提供了发送、接收等所有对电子邮件进行处理的功能。
MAPISession控件用来注册一个新工作期和注销当前工作期。注册时,首先
用MAPISession控件的SignOn方法建立与E-mail服务器的会话连接,显示完注册对话框后,SessionID属性包含了刚注册的MAPISession的句柄。此句柄最终必须传递给MAPIMessage控件,在结束当前MAPISession工作期之前,必须先注销该工作期。然后再用MAPIMessage控件的SessionID属性同有效的会话联系起来,执行一系列消息系统函数,实现收发邮件的功能。
二.MAPI控件的主要属性
(1)MAPISession控件的属性:
Action属性:当MAPISession控件被激活时,该属性将决定执行什么操作。
LogonUI属性:该属性指定是否显示注册对话框。当其值为“真”时,则出
现一个对话框提示新用户输入用户名和口令;当其值为“假”时,则不显示对话框。
SessionID属性:返回当前的消息会话句柄。指定SignOn方法时,可以设置该属性的值。使用MAPIMessage控件处理消息时,需要使用此会话句柄,其缺省值为0。
SignOn方法:将用户登录到UserName和Password属性所指定的帐户中,并将会话句柄存储到属性SessionID中。
SignOff方法:结束消息会话,从UserName和Password属性所指定的帐户中
退出。
(2)MAPIMessage控件的属性:
Action属性:当MAPIMessage控件被激活时,该属性决定将执行什么操作。
SessionID属性:存储由MAPISession控件的SessionID属性返回的消息会话句柄。
FetchSorted属性:在用收件箱中的消息填充消息集合时,指定或返回消息的排序。当其值为“真”时,按接收消息的顺序向消息集合添加消息;当其值为“假”时,由用户收件箱中的排序添加消息。
FetchUnreadOnly属性:决定是否将消息集合中的消息限定为未读消息。当其值为“真”时,只向消息集合添加FetchMsgType属性指定的未读消息;当其值为“假”时,添加收件箱中适当类型的全部消息。
MsgCount属性:用于在消息工作期间返回存在于消息设置中的消息的总数。
MsgIndex属性:指定当前索引消息的索引编号。在索引改变时,所有消息的其它属性也随之改变,以反映索引消息的特征。索引号的范围是从-1到MsgCount-1。
MsgOrigDisplayName属性:返回当前索引消息的原始发件人的名字。
MsgOrigAddress属性:返回当前索引消息的原始发件人的邮件地址。
RecipDisplayName、RecipAddress、MsgSubject、MsgNoteText属性:分别指定当前索引的收件人姓名、收件人的邮件地址、主题、文本行,构成一条完整的消息。
Send方法:发送一条消息。它带有一个参数nDialog,当nDialog为“真”时,显示Exchange邮件系统的操作界面,由用户输入消息的各个部分,并将消息提交邮件服务器传送;当nDialog为“假”时,则不显示相应的操作界面,而将消息提交给邮件服务器。
Reply方法:响应一个消息。将当前索引的消息复制到构成缓冲区中,并将RE:加入标题行的开始,同时将MsgIndex属性设置为-1。
Delete方法:删除一个消息、收件人或附件。
Compose方法:构成一条消息。
Fetch方法:由收件箱中选择的消息创建一个消息集合。
三.应用实例
★应用实例一:用VB 5.0的MAPI控件收发邮件。
1. 插入MAPI控件的方法:
在VB 5.0主菜单的“工程”项中选择“部件(0)”,在弹出的控件栏中,双击“Microsoft MAPI Control 5.0”项,按“确定”键返回。那么,在窗体工具箱中就有了上述控件。
2.建立含有如下控件的窗体:
控件 NAME CAPTION
主窗体 frmMail 用VB 5.0的MAPI控件收发邮件
MAPISession控件 MailSess
MAPIMessage控件 MailMess
命令按钮 cmdNewMail 发件箱
命令按钮 cmdGetMail 收件箱
命令按钮 cmdExit 退出
子窗体 frmNewMail 发件箱
标签 label1 收件人:
标签 label2 主题:
文本框 TEXT1 ´输入收件人的电子邮件地址
文本框 TEXT2 ´输入文本的主题
文本框 TEXT3 ´输入文本内容
命令按钮 MailSend 发送邮件
子窗体 frmGetMail 收件箱
标签 label1 发件人:
标签 label2 主题:
文本框 TEXT1 ´发件人的电子邮件地址
文本框 TEXT2 ´发来的文本主题
文本框 TEXT3 ´发来的文本内容
命令按钮 cmdPrevious 向前
命令按钮 cmdNext 向后
输入主窗体“发件箱”按钮的程序代码:
Private Sub cmdNewMail_Click()
frmNewMail.Show
End Sub
输入主窗体“收件箱”按钮的程序代码:
Private Sub cmdGetMail_Click()
frmGetMail.Show
End Sub
输入主窗体“退出”按钮的程序代码:
Private Sub cmdExit_Click()
frmMail.MailSess.SignOff ´断开连接
End
End Sub
输入frmNewMail子窗体“发送邮件”按钮的程序代码:
Private Sub MailSend_Click()
frmMail.MailSess.SignOn ´建立连接
frmMail.MailMess.SessionID = frmMail.MailSess.SessionID
frmMail.MailMess.MsgIndex = -1
frmMail.MailMess.RecipDisplayName = Text1.Text
frmMail.MailMess.MsgSubject = Text2.Text
frmMail.MailMess.MsgNoteText = Text3.Text
frmMail.MailMess.Send (False)
frmMail.MailSess.SignOff
End Sub
输入frmGetMail子窗体装入的程序代码:
Private Sub Form_Load()
Dim mailIndex, mailCounts As Integer
frmMail.MailSess.SignOn
frmMail.MailMess.SessionID = frmMail.MailSess.SessionID
frmMail.MailMess.FetchSorted = True
frmMail.MailMess.FetchUnreadOnly = True
frmMail.MailMess.Action = 1
mailCounts = frmMail.MailMess.MsgCount
If mailCounts = 0 Then
Text3.Text = "收件箱中没有邮件!"
frmGetMail.cmdPrevious.Enabled = False
frmGetMail.cmdNext.Enabled = False
Else
frmGetMail.MailMess.MsgIndex = 0
frmGetMail.Text1.Text = frmMail.MailMess.MsgOrigAddress
frmGetMail.Text2.Text = frmMail.MailMess.MsgSubject
frmGetMail.Text3.Text = frmMail.MailMess.MsgNoteText
End If
End Sub
输入frmGetMail子窗体“向前”按钮的程序代码:
Private Sub cmdPrevious_Click()
mailIndex = frmGetMail.MailMess.MsgIndex
frmGetMail.MailMess.MsgIndex = mailIndex - 1
frmGetMail.Text1.Text = frmMail.MailMess.MsgOrigAddress
frmGetMail.Text2.Text = frmMail.MailMess.MsgSubject
frmGetMail.Text3.Text = frmMail.MailMess.MsgNoteText
If mailIndex = 0 Then
frmGetMail.cmdPrevious.Enabled = False
End If
End Sub
输入frmGetMail子窗体“向后”按钮的程序代码:
Private Sub cmdNext_Click()
mailCounts = frmGetMail.MailMess.MsgCount - 1
mailIndex = frmGetMail.MailMess.MsgIndex
frmGetMail.MailMess.MsgIndex = mailIndex + 1
frmGetMail.Text1.Text = frmMail.MailMess.MsgOrigAddress
frmGetMail.Text2.Text = frmMail.MailMess.MsgSubject
frmGetMail.Text3.Text = frmMail.MailMess.MsgNoteText
If mailIndex = mailCounts Then
frmGetMail.cmdNext.Enabled = False
End If
End Sub
★应用实例二:用VFP 5.0的MAPI控件收发邮件。
1. 插入MAPI控件的方法:
在VFP 5.0主菜单的“工具”项中选择“选项”,在弹出的控件栏中,双击“Microsoft MAPI Control 5.0”项,那么,在窗体工具箱中就有了上述控件。
2.建立含有如下控件的窗体:
控件 NAME CAPTION
窗体 frmMail 用VFP 5.0的MAPI控件收发邮件
MAPISession控件 MailSess
MAPIMessage控件 MailMess
命令按钮 command1 发件箱
命令按钮 command2 收件箱
命令按钮 command3 退出
输入“发件箱”按钮单击事件的程序代码:
thisform.MailSess.SignOn
thisform.MailMess.SessionID = thisform.MailSess.SessionID
thisform.MailMess.MsgIndex = -1
thisform.MailMess.RecipDisplayName = "zjport@public.jsinfo.com.cn"
thisform.MailMess.MsgSubject = "信件"
thisform.MailMess.MsgNoteText = "请给我发邮件!"
thisform.MailMess.Send (.F.)
thisform.MailSess.SignOff
输入“收件箱”按钮单击事件的程序代码:
thisform.MailSess.SignOn
thisform.MailMess.SessionID = thisform.MailSess.SessionID
thisform.MailMess.FetchSorted = .T.
thisform.MailMess.FetchUnreadOnly = .T.
thisform.MailMess.Action = 1
xx=´´
for mm=0 to thisform.MailMess.MsgCount-1
thisform.MailMess.MsgIndex = mm
xx=xx+thisform.MailMess.MsgNoteText+chr(13)+chr(10)
endf
thisform.MailSess.SignOff
输入“退出”按钮的程序代码:
thisform.MailSess.SignOff
release thisform
上述程序只是给出用VB 5.0和VFP 5.0开发E-mail程序的简单案例,用户可以结合自己的实际情况,将上述程序修改、完善后,加入到自己的应用系统中去,使应用系统的功能更强大。
以上程序在同创P/200、中文WINDOWS 95、WINDOWS NT 4.0、Visual Foxpro 5.0、Visual Basic 5.0软、硬件环境中运行并通过。