Outlook的Automation对象编程方法

7007

Microsoft Outlook是可编程桌面信息管理程序。由于Microsoft Outlook本身不包含Visual Basic for Applications，但包括完整的类型库(type library)和Visual Basic Scripting Edition (VBScript)，因此，Outlook对象编程可以采用两种方法：即VBScript脚本编程方法和Automation自动化编程方法。
VBScript脚本编程方法一般用于设计基于Outlook的本地化解决方案；而Automation（或OLE Automation）自动化编程方法则是用于建立用户自己的群件或邮件系统。可以使用早期绑定或后期绑定来开始一个Automation过程。本文将以后期绑定为例介绍在Delphi 5编程环境下，Outlook的Automation对象编程方法。
Outlook对象模型
Outlook基于Microsoft Exchange消息系统，更具体地说是基于MAPI(Messaging Application Programming Interface)来存储数据。若将Outlook安装到一台没有其他任何消息组件的计算机中，则安装程序会自动安装基于MAPI的Microsoft Exchange消息系统。
与任何一种消息系统一样，Microsoft Exchange使用一个层次化的文件夹(Folder)集合来存储数据。文件夹可以包含子文件夹（如收件箱、发件箱等）和条目（Item）（如邮件消息、约会、联系人和任务等）。正是由于这种不确定性，使Outlook编程与以文档为中心的其他Office产品编程相比更具挑战性，是所有Microsoft Office程序中对象编程最复杂的一种。Automation解决方案在很大程度上就是在这种文件夹层次中导航。
在Outlook对象模型中，Application对象包含NameSpace对象；NameSpace对象包含给定数据源（如MAPI消息库）中所有文件夹，即MAPIFolder对象集合；MAPIFolder对象包含该文件夹中所有条目对象；每个条目对象包含用于对其进行控制的可编程对象。
各对象含义如下：
●Application对象是整个模型的根对象，由CreateOleObject或GetActiveOleObject 函数返回；
●NameSpace对象代表任何可识别数据源，如MAPI消息库；
●Folders对象集合包括指定消息库（或任何可识别数据源）及其下级文件夹中所有的MAPIFolder文件夹对象；
●Items对象集合包括指定文件夹中所有Item条目对象；
●Explorer对象用于显示一个文件夹的窗口；
●Inspector对象用于显示一个条目的窗口。
Outlook对象编程步骤
1．在Delphi 5中，采用后期绑定来初始化一个Automation过程时，建议引用outlook8.pas单元，该单元包括Outlook类型库中所用常量定义。
2．建立一个Application类的实例。
3．调用GetNamespace过程指定要使用的名字空间。
若使用后期绑定，则所有对象变量均必须为Variant类型，如OutlookApplication, OutlookNameSpace等。
OutlookNameSpace:=Outlook.GetNamespace
(‘MAPI’);
4．调用Outlook名字空间的Logon 方法登记到邮件系统。该方法的四个参数的含义分别为Microsoft Exchange Profile文件名、口令、是否显示标准登录对话框、是否建立一个新的Microsoft Exchange会话。例如：  
OutlookNameSpace.Logon(ProfileStr, PasswordStr, False, True);
5．调用Outlook名字空间的GetDefaultFolder方法返回所请求的默认的MapiFolder文件夹对象（即MAPI名字空间内的一个文件夹）。例如，将默认的Contacts文件夹对象赋给OutlookFolder变量的方法如下：
OutlookFolder := OutlookNameSpace.
GetDefaultFolder(olFolderContacts);
又如，下列语句可以显示发件箱文件夹名称：
Caption := Variant(OutlookNameSpace.
GetDefaultFolder(olFolderOutbox));
此外，还可以使用文件夹集合Folders（索引）方法查找文件夹。这是查找自定义、非标准文件夹的唯一方法。如：
urgentFolder := olMAPI.Folders(“Mailbox － Zhang Chunming”).Folders(“Urgent”);
下面例子显示收件人ZhangChunming的共享日历文件夹：
OutlookReciepientItem := OutlookNameSpace.
CreateRecipient(‘ZhangChunming’);
OutlookReciepientItem.Resolve;
if OutlookReciepientItem.Resolved <> 0 then
begin
OutlookFolder := OutlookNameSpace.
GetSharedDefaultFolder(OutlookReciepientItem,  
olFolderCalendar);
OutlookFolder.Display;
end;
6．用MAPIFolder对象的Items属性返回该对象包含的条目对象集合。
有三种方法可以返回指定的条目对象：
&#9679;可以用Items（名字）方法返回指定的条目对象。如：下面语句返回指定文件夹中题目为&#8220;会议通知&#8221;的条目对象：
　 OutlookMailItem:=OutlookFolder.Items(&#8216;会议通知&#8217;);
&#9679;也可以用Items（索引）方法返回指定的条目对象。返回指定文件夹中第一个条目对象的方法如下：
　　OutlookMailItem := OutlookFolder.Items(1);
下面例子遍历指定文件夹（MAPIFolder对象）中所有条目对象集合，并显示条目主题。
for i := 1 to OutlookFolder.Items.Count do
begin
Caption := Caption ＋&#8216;－&#8217; ＋ String(OutlookFolder.Items);
OutlookFolder.Items.Display;
end;
注意：若指定文件夹不包括任何条目，则Items对象集合的Count属性为0。
&#9679;还可以用Items条目集合的Find方法查找条目。这是在Outlook文件夹中查找那些没有唯一标识的条目的唯一可行的方法。如：
OutlookMailItem := OutlookFolder.Items.Find(&#8216;[Subject] = &#8220;会议通知&#8221;&#8217;);
一旦找到满足搜索条件的第一个条目，可以用FindNext方法继续搜索其余条目。
有两种方法可以建立新条目对象：
&#9679;用Application对象的CreateItem方法创建默认条目对象，如AppointmentItem、ContactItem、JournalItem、MailItem、NoteItem、PostItem或TaskItem等。Outlook自动将新建条目保存到默认文件夹中。下面语句创建一个新邮件：
OutlookMailItem := Outlook.CreateItem
(olMailItem);
下面语句创建一个新联系人：
OutlookContactItem := Outlook.CreateItem(olContactItem);
&#9679;用Items对象集合的Add方法创建指定类型的条目对象。若未指定条目对象类型，则默认为父文件夹条目对象类型。若该文件夹从未指定类型，则默认条目对象类型为MailItem。下面语句将在当前Contacts文件夹中新建一个ContactItem条目。
OutlookContactItem := Outlook.GetNamespace
(&#8216;MAPI&#8217;).GetDefaultFolder (olFolderContacts)
.Items.Add;  
也可以如下所示分成几行语句完成：
OutlookNameSpace := Outlook.GetNamespace(&#8216;MAPI&#8217;);
OutlookFolder := OutlookNameSpace.
GetDefaultFolder(olFolderContacts);
OutlookContactItem := OutlookFolder.Items.Add(olContactItem);
还可以使用自定义表单向当前Contacts文件夹中加入新联系人，如：
OutlookFolder := OutlookNameSpace.
GetDefaultFolder(olFolderContacts);
OutlookContact := OutlookFolder.Items.Add(&#8216;IPM.Contact.MyForm&#8217;);
最后，调用Item对象的Save或Send方法保存或发送新建条目。
不论是MAPIFolder对象还是Item对象，均可以调用Display方法显示对应的窗口。如OutlookContactFolder.Display可以显示联系人文件夹，OutlookTaskItem.Display可以显示任务条窗口等。
OutlookTaskItem.Display;
编程实例：创建并发送一个新邮件消息
首先调用发件箱文件夹Items条目对象集合的Add方法创建新邮件条目对象（olMailItem类型）；其次调用Recipients 对象集合的Add方法来创建一个收件人，调用Attachments对象集合的Add方法来增加一个附件；然后设置邮件消息的Subject（主题）、Body（正文）（事实上所有Outlook对象都有主题和正文属性）、To（收件人）等属性；最后调用Send方法发送邮件。
完整的程序清单如下所示：
procedure SendMail;
var
Outlook: variant;{ Application }
OutlookNameSpace: variant;{ NameSpace }
OutlookFolder: variant;{ MAPIFolder }
OutlookMailItem: variant;{ MailItem }
OutlookRecipient: variant;{ Recipient }
OutlookAttachment: variant;{ Attachment }
begin
try
http://www.cnblogs.com/myamanda/admin/outlook:=CreateOleObject(&#8216;Outlook.
Application&#8217;);
except
ShowMessage(&#8216;无法启动Microsoft Outlook！&#8217;);
Exit;
end;
try
OutlookNameSpace := Outlook.GetNamespace(&#8216;MAPI&#8217;);
{ 创建新邮件消息 }
OutlookFolder := OutlookNameSpace.GetDefault
Folder(olFolderOutbox);
{ 增加收件人（若地址薄中已有此人，则仅用其名字即可，否则必须包括完整地址，如OutlookNameSpace.CurrentUser.Address）}
OutlookMailItem := OutlookFolder.Items.Add(olMailItem);
OutlookRecipient := OutlookMailItem.
Recipients.
Add(&#8216;ZhangChunming&#8217;);
OutlookRecipient.Type := olTo;
if not OutlookRecipient.Resolve then
begin
ShowMessage(&#8216;无法解析地址！&#8217;);
Exit;
end;
{ 插入附件（确保路径正确） }
OutlookAttachment := OutlookMailItem.
Attachments.Add(&#8216;c:\readme.txt&#8217;);
OutlookAttachment.DisplayName := &#8216;样本附件&#8217;;
{ 设置邮件主题、邮件正文和重要性 }
OutlookMailItem.Subject := &#8216;邮件主题&#8217;;
OutlookMailItem.Body := &#8216;此处为邮件内容&#8217;;
OutlookMailItem.Importance := olImportanceHigh;
OutlookMailItem.Send;
finally
OutlookRecipient := Unassigned;
OutlookAttachment := Unassigned;
OutlookMailItem := Unassigned;
OutlookFolder := Unassigned;
OutlookNameSpace := Unassigned;
Outlook := Unassigned;
end;
注意：为避免程序运行时产生异常，程序做了相应的异常处理，如：调用收件人的Resolve方法以确保收件人的有效性等。