任务对话框

本节包含与任务对话框一起使用的编程元素的相关信息。 任务对话框类似于基本消息框，但比它要灵活得多。

概述

主题	目录
关于任务对话框	介绍任务对话框的要素。

函数

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