“任务”对话框

项目
03/12/2025

本部分包含有关用于任务对话框的编程元素的信息。 任务对话框 与基本消息框相比更为灵活。

综述

主题	内容
“关于任务”对话框	描述任务对话框的元素。

功能

主题	内容
TaskDialog	创建、显示和作任务对话框。任务对话框包含应用程序定义的消息文本和标题、图标以及预定义的按下按钮的任意组合。此函数不支持注册回调函数来接收通知。
TaskDialogCallbackProc	与 TaskDialogIndirect 函数一起使用的应用程序定义函数。当发生各种事件时，它会从任务对话接收消息。 PFTASKDIALOGCALLBACK 类型定义指向此回调函数的指针。 TaskDialogCallbackProc 是应用程序定义的函数名称的占位符。
TaskDialogIndirect	创建、显示和作任务对话框。任务对话框包含应用程序定义的图标、消息、标题、验证复选框、命令链接、推送按钮和单选按钮。此函数可以注册回调函数来接收通知消息。

消息

主题	内容
TDM_CLICK_BUTTON	模拟任务对话框中按钮单击的作。
TDM_CLICK_RADIO_BUTTON	模拟任务对话框中单选按钮单击的作。
TDM_CLICK_VERIFICATION	模拟任务对话框中单击的验证复选框的作。
TDM_ENABLE_BUTTON	启用或禁用任务对话框中的推送按钮。
TDM_ENABLE_RADIO_BUTTON	启用或禁用任务对话框中的单选按钮。
TDM_NAVIGATE_PAGE	使用新内容重新创建任务对话框，模拟多页向导的功能。
TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE	指定给定的任务对话框按钮或命令链接是否应具有用户帐户控制（UAC）防护图标;也就是说，按钮调用的作是否需要提升。
TDM_SET_ELEMENT_TEXT	更新任务对话框中的文本元素。
TDM_SET_MARQUEE_PROGRESS_BAR	指示是否应在选集模式下显示托管进度栏。
TDM_SET_PROGRESS_BAR_MARQUEE	启动和停止进度栏的选美显示，并设置选区的速度。
TDM_SET_PROGRESS_BAR_POS	设置进度栏的当前位置。
TDM_SET_PROGRESS_BAR_RANGE	设置托管进度栏的最小值和最大值。
TDM_SET_PROGRESS_BAR_STATE	设置进度栏的当前状态。
TDM_UPDATE_ELEMENT_TEXT	更新任务对话框中的文本元素。
TDM_UPDATE_ICON	刷新任务对话框的图标。

通知

主题	内容
TDN_BUTTON_CLICKED	当用户在任务对话框中选择按钮或命令链接时，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_CREATED	在创建任务对话框后以及显示任务对话框之前，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_DESTROYED	在任务对话框被销毁且窗口句柄不再有效时发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_DIALOG_CONSTRUCTED	在创建任务对话框后以及显示任务对话框之前，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_EXPANDO_BUTTON_CLICKED	当用户单击任务对话框的展开按钮时，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_HELP	当用户在任务对话框具有焦点时按键盘上的 F1 时，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_HYPERLINK_CLICKED	当用户在任务对话内容中单击超链接时，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_NAVIGATED	导航发生时由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_RADIO_BUTTON_CLICKED	当用户在任务对话框中选择按钮或命令链接时，由任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_TIMER	任务对话框大约每 200 毫秒发送一次。在 dwFlags 传递给 TaskDialogIndirect 函数的 TASKDIALOGCONFIG 结构的成员中设置TDF_CALLBACK_TIMER标志时，将发送此通知代码。此通知代码仅通过任务对话框回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。
TDN_VERIFICATION_CLICKED	当用户单击任务对话框验证复选框时，任务对话框发送。此通知代码仅通过任务对话回调函数接收，该函数可以使用 TaskDialogIndirect 方法进行注册。

结构

主题	内容
TASKDIALOG_BUTTON	包含用于在任务对话框中显示按钮的信息。 TASKDIALOGCONFIG 结构使用此结构。
TASKDIALOGCONFIG	包含用于显示任务对话框的信息。 TaskDialogIndirect 函数使用此结构。