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

以下通知之一。

通知	使用情况
TDN_BUTTON_CLICKED	指示已选择按钮。 按钮的命令 ID 由 wParam 指定。
TDN_CREATED	指示已创建任务对话框。
TDN_DESTROYED	指示任务对话框已被销毁。
TDN_DIALOG_CONSTRUCTED	指示已创建任务对话框，但尚未显示。
TDN_EXPANDO_BUTTON_CLICKED	指示已选择展开按钮。
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)