IProgressDialog：：SetLine 方法 (shlobj_core.h)

  • 项目

在进度对话框中显示一条消息。

语法

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

参数

dwLineNum

类型：DWORD

要显示文本的行号。 目前有三行 - 1、2 和 3。 如果在调用 IProgressDialog：：StartProgressDialog 时 dwFlags 参数中包含PROGDLG_AUTOTIME标志，则只能使用第 1 行和第 2 行。 预计时间将显示在第 3 行。

[in] pwzString

类型： PCWSTR

包含文本的以 null 结尾的 Unicode 字符串。

fCompactPath

类型： BOOL

如果 路径字符串太大而无法容纳在行上，则为 TRUE。 路径使用 PathCompactPath 进行压缩。

pvResevered

类型： LPCVOID

保留。 设置为 NULL。

返回值

类型： HRESULT

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

注解

此函数通常用于显示诸如“项 XXX 正在处理”之类的消息。通常，消息显示在第 1 行和第 2 行，第 3 行保留预计时间。

要求

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

另请参阅

IProgressDialog