关于任务对话框

任务对话框是可用于显示信息并接收用户的简单输入的文本框。 与消息框类似，其格式由操作系统根据你设置的参数进行设置。 但是，任务对话框的功能比消息框有更多。

注意

任务对话框需要使用单线程单元 (STA) 模型。

 

任务对话框的部件

任务对话框由多个元素组成，其中大部分均为可选。 下图显示了任务对话框的各个部件。

在下图中，用户单击了折叠控件文本旁边的按钮，从而在此处和页脚显示了替代文本。

插图显示了以下部件：

组成部分	说明	TASKDIALOGCONFIG 成员
Window title	窗口的描述文字。	pszWindowTitle
主图标	一个表示任务对话框用途的大图标。	hMainIcon 或 pszMainIcon
主要说明	主体文本。	pszMainInstruction
内容	额外文本。	pszContent
进度栏	显示某些任务进度的动画栏。	dwFlags
单选按钮	适用于用户的应用程序定义的选项。	pRadioButtons
自定义按钮	某个按钮并非常用按钮之一。 它既可以是一个普通按钮，也可以如图所示，是一个最多包含两行文本的命令链接。	pButtons
展开/折叠按钮	一个用于在应用程序定义的折叠控制文本（如“查看更多详细信息”）和展开控制文本（可以是两行或多行）之间切换的按钮。 当控件文本展开时，pszExpandedInformation 中的附加文本也会显示在内容文本之后，或者显示在页脚中（如图二所示）。	pszCollapsedControlText 和 pszExpandedControlText
“验证”复选框	一个附带应用程序定义的文本的复选框，用于做出简单的选择，比如“不再显示此对话框”。	pszVerificationText
页脚图标	表示页脚文本用途的小图标。	hFooterIcon 或 pszFooterIcon
页脚文本	附加文本。 在插图中，文本包含了一个超链接。	pszFooter
常用按钮	标准按钮；在插图中为 OK 按钮。	dwCommonButtons