PFTASKDIALOGCALLBACK コールバック関数 (commctrl.h)

  • [アーティクル]

TaskDialogCallbackProc 関数は、TaskDialogIndirect 関数で使用されるアプリケーション定義関数です。 さまざまなイベントが発生すると、タスク ダイアログからメッセージを受信します。

PFTASKDIALOGCALLBACK 型は、このコールバック関数へのポインターを定義します。 TaskDialogCallbackProc は、アプリケーション定義関数名のプレースホルダーです。

構文

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

パラメーター

[in] hwnd

種類: HWND

TaskDialog ウィンドウへのハンドル。 コールバック プロシージャが TDN_DESTROYED で呼び出されてから戻った後は、引き続き hwnd にメッセージを送信しないでください。

[in] msg

型: UINT

次のいずれかの通知。

Notification 使用
TDN_BUTTON_CLICKED ボタンが選択されていることを示します。 ボタンのコマンド ID は wParam で指定します。
TDN_CREATED タスク ダイアログが作成されたことを示します。
TDN_DESTROYED タスク ダイアログが破棄されたことを示します。
TDN_DIALOG_CONSTRUCTED タスク ダイアログが作成されたが、まだ表示されていないことを示します。
TDN_EXPANDO_BUTTON_CLICKED expando ボタンが選択されていることを示します。
TDN_HELP タスク ダイアログにフォーカスがある間に F1 キーが押されたことを示します。
TDN_HYPERLINK_CLICKED ハイパーリンクが選択されていることを示します。 リンク テキストへのポインターは 、lParam によって指定されます。
TDN_NAVIGATED ナビゲーションが発生したことを示します。
TDN_RADIO_BUTTON_CLICKED ラジオ ボタンが選択されていることを示します。 ラジオ ボタンのコマンド ID は wParam で指定します。
TDN_TIMER タスク ダイアログ タイマーが起動したことを示します。 合計経過時間は wParam で指定します。 進行状況バーを更新するには、hwnd パラメーターで指定されたウィンドウにTDM_SET_PROGRESS_BAR_POSメッセージを送信します。
TDN_VERIFICATION_CLICKED [タスク ダイアログの確認チェック] ボックスが選択されていることを示します。

[in] wParam

種類: WPARAM

追加の通知情報を指定します。 このパラメーターの内容は、 uNotification パラメーターの値によって異なります。

[in] lParam

種類: LPARAM

追加の通知情報を指定します。 このパラメーターの内容は、 uNotification パラメーターの値によって異なります。

lpRefData

種類: LONG_PTR

アプリケーション固有のデータへのポインター。 これは、タスク ダイアログの作成に使用される TASKDIALOGCONFIG 構造体の lpCallbackData メンバーが指すデータです。

戻り値

型: HRESULT

戻り値は、処理中の通知に固有です。 ボタンクリックに応答する場合、タスク ダイアログが閉じられない場合は、実装からS_FALSEが返されます。 それ以外の場合は、S_OKを返します。

注釈

アプリケーションは、TaskDialogIndirect を介してポインターを介して渡される TASKDIALOGCONFIG 構造体の pfCallback メンバーにそのアドレスを渡すことによって、このコールバック関数を登録する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー commctrl.h (Commctrl.h を含む)