IProgressDialog：：StartProgressDialog 方法 (shlobj_core.h)

  • 项目

启动进度对话框。

语法

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

参数

[in] hwndParent

类型：HWND

对话框的父窗口的句柄。

punkEnableModless

类型： IUnknown*

保留。 设置为 NULL。

dwFlags

类型：DWORD

控制进度对话框操作的标志。 以下值的组合：

PROGDLG_NORMAL

正常进度对话框行为。

PROGDLG_MODAL

进度对话框将与 hwndParent 指定的窗口模式化。 默认情况下，进度对话框是无模式的。

PROGDLG_AUTOTIME

自动估计剩余时间，并在第 3 行显示估算值。 如果设置了此标志， 则 IProgressDialog：：SetLine 只能用于显示第 1 行和第 2 行的文本。

PROGDLG_NOTIME

不显示“剩余时间”文本。

PROGDLG_NOMINIMIZE

不要在对话框的描述文字栏上显示最小化按钮。

PROGDLG_NOPROGRESSBAR

不显示进度栏。 通常，应用程序可以定量地确定剩余的操作量，并定期将该值传递给 IProgressDialog：：SetProgress。 进度对话框使用此信息更新其进度栏。 当调用应用程序必须等待操作完成，但没有任何可用于更新对话框的定量信息时，通常会设置此标志。

PROGDLG_MARQUEEPROGRESS

Windows Vista 及更高版本。 将进度栏设置为选框模式。 这会导致进度栏水平滚动，类似于选择显示。 如果希望指示正在进行进度，但操作所需的时间未知，请使用此选项。

PROGDLG_NOCANCEL

Windows Vista 及更高版本。 不显示“取消”按钮。 无法取消操作。 仅当绝对必要时才使用此选项。

pvResevered

类型： LPCVOID

保留。 设置为 NULL。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (5.0 或更高版本)

另请参阅

IProgressDialog