IProgressDialog::SetLine メソッド (shlobj_core.h)

進行状況ダイアログにメッセージを表示します。

構文

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

パラメーター

dwLineNum

型: DWORD

テキストを表示する行番号。 現在、1、2、3 の 3 行があります。 IProgressDialog::StartProgressDialog が呼び出されたときに、PROGDLG_AUTOTIME フラグが dwFlags パラメーターに含まれていた場合は、1 行目と 2 行目のみを使用できます。 推定時間は 3 行目に表示されます。

[in] pwzString

種類: PCWSTR

テキストを含む null で終わる Unicode 文字列。

fCompactPath

種類: BOOL

パス 文字列が大きすぎて行に収まらない場合に圧縮する場合は TRUE。 パスは PathCompactPath で圧縮されます。

pvResevered

種類: LPCVOID

予約済み。 NULL に設定します。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、通常、"Item XXX は現在処理中です" などのメッセージを表示するために使用されます。通常、メッセージは 1 行目と 2 行目に表示され、3 行目は推定時間に予約されています。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h
[DLL]	Shell32.dll (バージョン 5.0 以降)

こちらもご覧ください

IProgressDialog