IProgressDialog：：StartProgressDialog 方法 (shlobj_core.h)

發行項
03/02/2024

啟動進度對話框。

語法

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 和更新版本。 將進度列設定為 marquee 模式。這會導致進度列水平捲動，類似於 Marquee 顯示器。當您想要指出正在進行進度，但作業所需的時間未知時，請使用此專案。

PROGDLG_NOCANCEL

Windows Vista 和更新版本。 不要顯示取消按鈕。無法取消作業。只有在絕對必要時，才使用這個值。

pvResevered

類型： LPCVOID

保留的。設定為 NULL。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h
Dll	Shell32.dll (5.0 版或更新版本)

另請參閱

IProgressDialog

共用方式為