“任务”对话框
本部分包含有关用于任务对话框的编程元素的信息。 任务对话框 与基本消息框相比更为灵活。
综述
| 主题 | 内容 |
|---|---|
| “关于任务”对话框 | 描述任务对话框的元素。 |
功能
| 主题 | 内容 |
|---|---|
| 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 函数使用此结构。 |