TDM_NAVIGATE_PAGE メッセージ

タスク ダイアログを新しい内容で再作成し、マルチページ ウィザードの機能をシミュレートします。

パラメーター

wParam [in]

使用されていません。 ゼロを指定してください。

lParam [in]

作成するタスク ダイアログを記述する TASKDIALOGCONFIG 構造体へのポインター。 呼び出し元のアプリケーションは、この構造体を割り当て、そのメンバーを設定する必要があります。 メンバーの値は、ユーザーが移動するページの種類によって異なります。

戻り値

戻り値は無視されます。

解説

ウィザード タスク ダイアログを起動するには、 TaskDialogIndirect 関数を使用します。 ユーザーがウィザードを使用して移動すると、タスク ダイアログにこのメッセージが送信され、次のページが表示されます。 lParam が指す構造体で指定された要素を使用して、新しいタスク ダイアログ (新しいページのように見えます) が作成されます。 作成時に、ダイアログ フレームの内容全体が破棄され、再構築されます。 その結果、ダイアログ内のコントロールによって保持されている状態情報 (進行状況バー、エキスパンド ボタン、検証チェック ボックスなど) は失われます。

タスク ダイアログのレイアウトが失敗し、戻り値に反映されない場合があります。 S_OKの戻り値には、タスク ダイアログがメッセージを受信し、処理を試みたことが反映されます。 タスク ダイアログのレイアウトが失敗した場合 (タスク ダイアログを表示できません)、ダイアログが閉じ、登録されたコールバック関数で HRESULT コードが返されます。 コールバック関数の構文の詳細については、「 TaskDialogCallbackProc」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h