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 或更高版本) |