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 的值是指是否可以使用省略号 (...) 截断文本字符串，以节省屏幕空间。