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

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

構文

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 エラー コードを返します。

要件

こちらもご覧ください

IProgressDialog