IActionProgress：：UpdateText 方法 (shobjidl_core.h)

  • 项目

如果与操作关联的描述性文本将发生更改，则调用 。

语法

HRESULT UpdateText(
  [in] SPTEXT  sptext,
  [in] LPCWSTR pszText,
  [in] BOOL    fMayCompact
);

参数

[in] sptext

类型： SPTEXT

一个 值，该值指定显示的文本类型。 有关可接受的值，请参阅 SPTEXT 。

[in] pszText

类型： LPCWSTR

指向要显示的宽字符串的指针。

[in] fMayCompact

类型： BOOL

一个 值，该值指定是否允许压缩文本字符串以适应屏幕上的可用空间。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值。

注解

实现此方法的类必须在所执行的操作和向用户显示进度的 UI 的上下文中解释 sptext 和 fMayCompact 的值。 sptext 的值可用于区分可更改文本行。 通常， fMayCompact 的值是指是否可以使用省略号 (...) 截断文本字符串，以节省屏幕空间。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shobjidl.idl

另请参阅

IActionProgress

SPTEXT