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

[アーティクル]
03/02/2024

[進行状況] ダイアログボックスを起動します。

構文

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

パラメーター

[in] hwndParent

型: HWND

ダイアログボックスの親ウィンドウへのハンドル。

punkEnableModless

種類: IUnknown*

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

dwFlags

型: DWORD

進行状況ダイアログボックスの操作を制御するフラグ。次の値の組み合わせ。

PROGDLG_NORMAL

[通常の進行状況] ダイアログボックスの動作。

PROGDLG_MODAL

進行状況ダイアログボックスは、 hwndParent で指定されたウィンドウに対してモーダルになります。既定では、進行状況ダイアログボックスはモードレスです。

PROGDLG_AUTOTIME

残りの時間を自動的に見積もり、3 行目に見積もりを表示します。このフラグが設定されている場合、 IProgressDialog::SetLine は 1 行目と 2 行目にテキストを表示する場合にのみ使用できます。

PROGDLG_NOTIME

"残り時間" テキストは表示しないでください。

PROGDLG_NOMINIMIZE

ダイアログボックスのキャプションバーに最小化ボタンを表示しないでください。

PROGDLG_NOPROGRESSBAR

進行状況バーは表示されません。通常、アプリケーションは、残っている操作の量を定量的に判断し、その値を IProgressDialog::SetProgress に定期的に渡すことができます。進行状況ダイアログボックスでは、この情報を使用して進行状況バーを更新します。通常、このフラグは、呼び出し元のアプリケーションが操作の完了を待機する必要があるが、ダイアログボックスの更新に使用できる定量的な情報がない場合に設定されます。

PROGDLG_MARQUEEPROGRESS

Windows Vista 以降。 進行状況バーをマーキーモードに設定します。これにより、マーキー表示と同様に、進行状況バーが水平方向にスクロールします。これは、進行状況が行われているが、操作に必要な時間が不明であることを示す場合に使用します。

PROGDLG_NOCANCEL

Windows Vista 以降。 キャンセルボタンは表示しません。操作を取り消すことはできません。これは、絶対に必要な場合にのみ使用してください。

pvResevered

種類: LPCVOID

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

戻り値

型: HRESULT

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

要件

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

こちらもご覧ください

IProgressDialog