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，否則傳回錯誤值。

實作這個方法的類別必須在所執行動作的內容中解譯 sptext 和 fMayCompact 的值，以及向使用者顯示進度的 UI。 sptext 的值可用來區分可變更的文字行。 fMayCompact 的值通常是指是否可以使用省略號 (...) 來截斷文字字串，以節省螢幕空間。