任务对话框
本节包含与任务对话框一起使用的编程元素的相关信息。 任务对话框类似于基本消息框，但比它要灵活得多。
概述
| 主题 | 目录 |
|---|---|
| 关于任务对话框 | 介绍任务对话框的要素。 |
函数
| 主题 | 目录 |
|---|---|
| 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 毫秒由任务对话框发送一次。 当传给 TaskDialogIndirect 函数的 TASKDIALOGCONFIG 结构的 dwFlags 成员中设置了 TDF_CALLBACK_TIMER 标志时，将发送此通知代码。 此通知代码只能通过任务对话框回调函数来接收，可使用 TaskDialogIndirect 方法注册该函数。 |
| TDN_VERIFICATION_CLICKED | 当用户单击任务对话框验证复选框时由任务对话框发送。 此通知代码只能通过任务对话框回调函数来接收，可使用 TaskDialogIndirect 方法注册该函数。 |
结构
| 主题 | 目录 |
|---|---|
| TASKDIALOG_BUTTON | 包含用于在任务对话框中显示按钮的信息。 TASKDIALOGCONFIG 结构使用此结构。 |
| TASKDIALOGCONFIG | 包含用于显示任务对话框的信息。 TaskDialogIndirect 函数使用此结构。 |