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 で 、sptextfMayCompact の値を解釈する必要があります。 sptext の値を使用して、変更可能なテキストの行を区別できます。 fMayCompact の値は、多くの場合、画面領域を節約するために、省略記号 (...) でテキスト文字列を切り捨てることができるかどうかを示します。

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)
[DLL] Shobjidl.idl

こちらもご覧ください

IActionProgress

SPTEXT