共用方式為

IProgressDialog：：SetCancelMsg 方法 (shlobj_core.h)

  • 發行項

設定使用者取消作業時要顯示的訊息。

語法

HRESULT SetCancelMsg(
  [in] PCWSTR  pwzCancelMsg,
       LPCVOID pvResevered
);

參數

[in] pwzCancelMsg

類型： PCWSTR

Null 終止 Unicode 字串的指標，其中包含要顯示的訊息。

pvResevered

類型： LPCVOID

保留的。 設定為 NULL。

傳回值

類型： HRESULT

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

備註

即使使用者按兩下 [ 取消]，應用程式仍無法立即呼叫 IProgressDialog：：StopProgressDialog 來關閉對話框。 應用程式必須等到下次呼叫 IProgressDialog：：HasUserCancelled ，以探索使用者已取消作業。 由於此延遲可能很重要，因此進度對話框會藉由清除文字行 1 和 2，並在第 3 行顯示取消訊息，為使用者提供立即的意見反應。 此訊息旨在讓使用者知道延遲正常，而且很快就會關閉進度對話方塊。 它通常會設定為類似「請稍候...」之類的專案。

規格需求

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

另請參閱

IProgressDialog