IProgressDialog：：StartProgressDialog 方法 (shlobj_core.h)

项目
08/26/2023

启动进度对话框。

语法

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

通过