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 以降) |