MAPI 进度指示器
适用于:Outlook 2013 | Outlook 2016
为客户端执行的许多操作可能需要很长时间才能完成。 若要通知客户端长时间操作的进度,可以显示一个指示器,该指示器以图形方式显示从操作开始到完成操作的任何给定点的已完成部分。 进度指示器显示要完成的总操作的百分比。
以下方法支持长时间操作和进度指示器的显示:
IMAPIFolder::CopyMessages、 IMAPIFolder::CopyFolder、 IMAPIFolder::D eleteMessages、 IMAPIFolder::D eleteFolder、 IMAPIFolder::EmptyFolder 和 IMAPIFolder::SetReadFlags。
IMAPISupport::D oCopyProps、 IMAPISupport::D oCopyTo、 IMAPISupport::CopyFolder 和 IMAPISupport::CopyMessages。
为了显示进度指示器,MAPI 定义了进度对象。 Progress 对象实现 IMAPIProgress :IUnknown 接口,该接口包含用于建立指示器范围和创建显示的方法。 MAPI 提供进度对象实现,某些客户端也提供进度对象实现。 应使用客户端的实现(如果提供了),作为执行操作的方法的输入参数。 如果客户端传递 NULL 而不是指向进度对象的指针,则通过调用 IMAPISupport::D oProgressDialog 方法使用 MAPI 的实现。