显示进度指示器

项目
03/09/2022

适用于：Outlook 2013 | Outlook 2016

若要显示进度指示器，请调用 IMAPIProgress：：GetFlags 以检索当前标志设置。

如果MAPI_TOP_LEVEL，请完成以下步骤：

将变量设置为等于操作中要处理的项目总数。例如，如果要复制文件夹的内容，则此值将等于文件夹中子文件夹的数量以及邮件数。
将变量设置为等于 1000 除以项目数。
如果要显示子对象的进度，请调用进度对象的 IMAPIProgress：：SetLimits 方法，并传递以下三个参数的值：
- 将 lpulMin 参数设置为 0。
- 将 lpulMax 参数设置为 1000。
- 将 lpulFlags 参数设置为 MAPI_TOP_LEVEL。
对于要处理的每个对象，请完成以下步骤：
1. 调用 IMAPIProgress：：SetLimits 并传递以下三个参数的值：
- 将 lpulMin 参数设置为步骤 2 乘以当前项减 1 中设置的变量。
- 将 lpulMax 参数设置为步骤 2 中与当前对象相乘的变量集。
- 将 lpulFlags 参数设置为 0。
1. 对此对象执行应执行的任何处理。如果这是一个子对象，并且您希望显示子对象上的进度，则向该方法传递指向 lpProgress 参数中 progress 对象的指针。
2. 调用 IMAPIProgress：:P rogress 并传递以下三个参数的值：
- 将 ulValue 参数设置为步骤 2 中与当前对象相乘的变量集。
- 将 ulCount 参数设置为当前对象。
- 将 ulTotal 参数设置为步骤 1 中设置的变量（对象总数）。

如果未MAPI_TOP_LEVEL标志，请完成以下步骤：

调用进度对象的 IMAPIProgress：：GetMin 方法来检索显示器的最小值。
调用 IMAPIProgress：：GetMax 以检索显示器的最大值。
设置一个等于要处理的对象总数的变量。
将变量设置为等于最大值减去最小值后除以对象总数的结果。
对于要处理的每个对象，请完成以下步骤：
1. 如果提供程序显示子对象的进度，请调用 IMAPIProgress：：SetLimits 并传递以下三个参数的值：
- 将 lpulMin 参数设置为最小值加上当前项减去 1 乘以步骤 4 中设置的变量。
- 将 lpulMax 参数设置为最小值加上当前单位乘以步骤 4 中设置的变量。
- 将 lpulFlags 参数设置为 0。
1. 对此对象执行应执行的任何处理。如果对象是子对象，并且您的提供程序显示子对象的进度，则向该方法传递指向 lpProgress 参数中 progress 对象的指针。
2. 调用 IMAPIProgress：:P rogress 并传递以下三个参数的值：
- 将 ulValue 参数设置为步骤 2 中与当前对象相乘的变量集。
- 将 ulCount 参数 设置为 0。
- 将 ulTotal 参数设置为 0。

以下代码示例演示了在复制包含五个子文件夹的文件夹的内容的操作的所有级别显示进度所需的逻辑。

lpProgress->GetFlags (lpulFlags);
ulFlags = *lpulFlags;
/* The folder in charge of the display. It contains 5 subfolders. */
if (ulFlags & MAPI_TOP_LEVEL)
{
    ulItems = 5                         // 5 subfolders in this folder
    ulScale = (ulMax / ulItems)         // 200 because ulMax = 1000
    lpProgress->SetLimits(0, ulMax, MAPI_TOP_LEVEL)
    for (i = 1; i <= ulItems; i++)      // for each subfolder to copy
    {
        lpProgress->SetLimits( (i - 1) * ulScale, i * ulScale, 0)
        CopyOneFolder(lpFolder(i), lpProgress)
        lpProgress->Progress( i * ulScale, i, ulItems)
    }
}
else
/* One of the subfolders to be copied. It contains 3 messages. */
{
    lpProgress->GetMin(&ulMin);
    lpProgress->GetMax(&ulMax);
    ulItems = 3;
    ulDelta = (ulMax - ulMin) / ulItems;
    for (i = 1; i <= ulItems; i++)
    {
        lpProgress->SetLimits(ulMin + (i - 1) * ulDelta,
                              ulMin + i * ulDelta, 0)
        CopyOneFolder(lpFolder(i), lpProgress)
        /* Pass 0 for ulCount and ulTotal because this is not the */
        /* top-level display, and that information is unavailable */
        lpProgress->Progress( i * ulDelta, 0, 0)
    }
}

另请参阅

MAPI 进度指示器