ホーム › UI.Controls › PFTASKDIALOGCALLBACK

PFTASKDIALOGCALLBACK

コールバック

シグネチャ

HRESULT PFTASKDIALOGCALLBACK(
    HWND hwnd,
    DWORD msg,
    WPARAM wParam,
    LPARAM lParam,
    INT_PTR lpRefData
);

パラメーター

フィールド

型

説明

hwnd

HWND

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

msg

DWORD

次の通知のいずれかです。

通知	用途
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	タスクダイアログの確認チェックボックスが選択されたことを示します。

wParam

WPARAM

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

lParam

LPARAM

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

lpRefData

INT_PTR

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

公式ドキュメント

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

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

戻り値

型: HRESULT

戻り値は、処理する通知に応じて異なります。ボタンのクリックに応答する際、タスクダイアログを閉じない場合は S_FALSE を返すように実装してください。それ以外の場合は S_OK を返します。

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)