Windows Mobile 5.0中为开发人员提供的新功能(5)

Pocket Outlook 增强功能

Pocket Outlook 向用户和应用程序开发人员提供了易于使用的 PIM。将 Pocket Outlook 集成到您的应用程序中可以同时使您的应用程序和它的用户获益。用户通过具有一致的 PIM 体验和数据获益，而无论他们是直接与 Pocket Outlook 交互，还是通过您的应用程序与其交互。应用程序通过有机会立即合并用户的完整 PIM 数据而获益。

为了进一步简化应用程序与 Pocket Outlook 交互的方式以及为应用程序提供合并更为丰富的 Pocket Outlook 交互的机会，Pocket Outlook 向本机和托管开发人员提供了多种新功能。

联系人选择对话框

正如它的名称所暗示的那样，联系人选择对话框使应用程序能够显示功能齐全的联系人选择对话框 — 就像 Pocket Outlook 显示一样。该对话框提供了可供用户选择整个联系人或单个联系人属性（如电话号码或电子邮件地址）的筛选功能。当该对话框显示时，用户可以直接选择联系人，或者可以输入联系人姓名的一部分，后者会自动筛选列表以便只显示匹配的姓名。该对话框还可以选择支持用户添加新联系人。本机开发人员可以通过 ChooseContact 函数使用联系人选择对话框；托管开发人员需要使用 ChooseContactDialog 类。

下面的示例演示了如何从 C++ 和 C# 中使用联系人选择对话框。在每个示例中，应用程序都显示限制用户选择现有联系人的对话框。为了使示例保持简单，应用程序随后在 MessageBox 中显示所选联系人的姓名。

下面的代码演示 C++ 中的联系人选择对话框。

#include 
// ...
HRESULT hr = E_FAIL;
CHOOSECONTACT cc = {0};
cc.cbSize = sizeof (cc);
cc.dwFlags = CCF_RETURNCONTACTNAME | CCF_HIDENEW;
// Display the contact selection dialog
hr = ChooseContact(&cc);
// Show the selected name
MessageBox(NULL, cc.bstrContactName, TEXT("Selected Contact"), MB_OK); 
// Free memory
SysFreeString(cc.bstrContactName);

下面的代码演示 C# 中的联系人选择对话框。

using Microsoft.WindowsMobile.PocketOutlook;
using Microsoft.WindowsMobile.Forms;
// ...
ChooseContactDialogcontactDialog = new ChooseContactDialog();
contactDialog.HideNew = true;
contactDialog.ShowDialog();
// Show the selected name
MessageBox.Show(contactDialog.SelectedContactName, "Selected Contact");

图 3 说明了所显示的对话框。

图 3. 新的 ChooseContactDialog 联系人选择器类

事件通知

由于引入了事件通知，Windows Mobile 5.0 现在使应用程序可以比以往任何时候都更密切地与 Pocket Outlook 合作。通过事件通知，本机和托管应用程序都可以监视 Pocket Outlook 文件夹内部的成员添加、删除和修改。

要注册以接收这些通知，本机应用程序必须访问感兴趣的 Folder 对象上的 IItem 接口，然后调用 IItem.SetProp 方法以便将属性 PIMPR_FOLDERNOTIFICATION 设置为表 7 中的值之一。

当更改发生时，消息被发送到在对 IPOutlookApp.Logon 的调用中注册的窗口。表 8 显示可能的消息。

托管应用程序使用标准委托机制来处理由 AppointmentCollection、ContactCollection 和 TaskCollection 公开的 ListChanged 事件。借助于相应文件夹中的 Items 属性可以最为容易地访问这些集合。下面的示例演示如何注册委托以处理对约会集合所做的更改。

using Microsoft.WindowsMobile.PocketOutlook;
// ...
OutlookSessionsession = new OutlookSession();
session.Appointments.Items.ListChanged +=
   new ListChangedEventHandler(Items_ListChanged);
// ListChanged Event Handler
void Items_ListChanged(object sender, ListChangedEventArgs eventArgs)
{
 // Details of change are found in eventArgs
}

除了跟踪对某个文件夹内的所有对象的更改以外，托管开发人员还可以获得有关对任何特定 Appointment、Contact 或 Task 所做更改的通知。这些类中的每个属性都具有相应的事件。例如，要获得有关对 Appointment 的 Start 属性所做更改的通知，请处理 Appointment.StartChanged 事件。要获得有关对 Contact 的 BusinessTelephoneNumber 所做更改的通知，请处理 Contact.BusinessTelephoneNumberChanged 事件。

自定义属性

很多应用程序不仅使用 Pocket Outlook 提供的数据，而且还需要扩充标准 Pocket Outlook 对象模型以跟踪附加数据。过去，那些希望自己的应用程序这么做的开发人员必须显式管理扩充数据的存储及其与 Pocket Outlook 对象的相互关系。Windows Mobile 5.0 通过引入自定义属性消除了手动管理扩充内容的需要。

自定义属性使本机和托管应用程序都可以将自定义数据直接与 Appointment、Contact 和 Task 对象相关联。Pocket Outlook 自动将这一关联数据存储到它的可以通过相关联的 Appointment、Contact 或 Task 对象直接访问的数据存储区中。自定义属性可以是从简单类型（如 int）到复杂的自定义对象的任意类型。要访问自定义属性，本机应用程序开发人员可以使用 IItem.GetProps/IItem.SetProps；托管开发人员可以使用由 Appointment.Properties、Contact.Properties 和 Task.Properties 公开的 PimPropertySet 属性。