“任务”对话框

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

综述

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

功能

主题 内容
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 函数使用此结构。