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