CTaskDialog类选件

对象就象消息框，但在弹出对话框会显示附加信息传递给用户。CTaskDialog 还包括集合功能的信息从用户。

class CTaskDialog : public CObject

成员

构造函数

CTaskDialog::CTaskDialog

构造 CTaskDialog 对象。

方法

CTaskDialog::AddCommandControl	添加一个命令按钮控件。CTaskDialog。
CTaskDialog::AddRadioButton	添加一个单选按钮 CTaskDialog。
CTaskDialog::ClickCommandControl	单击命令按钮控件或通用按钮程序模型。
CTaskDialog::ClickRadioButton	单击单选按钮程序模型。
CTaskDialog::DoModal	显示CTaskDialog。
CTaskDialog::GetCommonButtonCount	检索可用常见的按钮数。
CTaskDialog::GetCommonButtonFlag	将标准Windows按钮为通用按钮类型与 CTaskDialog 选件类。
CTaskDialog::GetCommonButtonId	常见按钮类型的转换为与 CTaskDialog 选件类对标准Windows按钮。
CTaskDialog::GetOptions	返回此 CTaskDialog的可选标志。
CTaskDialog::GetSelectedCommandControlID	返回选定的命令按钮控件。
CTaskDialog::GetSelectedRadioButtonID	返回选定的单选按钮。
CTaskDialog::GetVerificationCheckboxState	检索验证复选框的状态。
CTaskDialog::IsCommandControlEnabled	确定命令按钮控件或通用按钮是否启用。
CTaskDialog::IsRadioButtonEnabled	确定单选按钮是否启用。
CTaskDialog::IsSupported	确定正在运行应用程序的计算机是否支持 CTaskDialog。
CTaskDialog::LoadCommandControls	添加命令按钮控件使用数据从字符串表。
CTaskDialog::LoadRadioButtons	添加单选按钮即可使用数据从字符串表。
CTaskDialog::NavigateTo	调用焦点到另一 CTaskDialog。
CTaskDialog::OnCommandControlClick	当用户单击命令按钮控件时，框架调用此方法。
CTaskDialog::OnCreate	然后再创建 CTaskDialog后，框架调用此方法。
CTaskDialog::OnDestroy	在它销毁 CTaskDialog之前，框架调用此方法。
CTaskDialog::OnExpandButtonClick	当用户单击展开按钮时，框架调用此方法。
CTaskDialog::OnHelp	当用户请求帮助时，框架调用此方法。
CTaskDialog::OnHyperlinkClick	当用户单击超链接时，框架调用此方法。
CTaskDialog::OnInit	当 CTaskDialog 初始化时，框架调用此方法。
CTaskDialog::OnNavigatePage	当用户移动焦点有关 CTaskDialog中的控件时，框架调用此方法。
CTaskDialog::OnRadioButtonClick	当用户选择一个单选按钮控件时，框架调用此方法。
CTaskDialog::OnTimer	当计时器过期时，框架调用此方法。
CTaskDialog::OnVerificationCheckboxClick	当用户单击验证复选框时，框架调用此方法。
CTaskDialog::RemoveAllCommandControls	从 CTaskDialog移除所有命令控件。
CTaskDialog::RemoveAllRadioButtons	从 CTaskDialog移除所有单选按钮。
CTaskDialog::SetCommandControlOptions	更新在 CTaskDialog的命令按钮控件。
CTaskDialog::SetCommonButtonOptions	更新将启用的常见按钮的子集并需要UAC特权提升。
CTaskDialog::SetCommonButtons	添加常见按钮。CTaskDialog。
CTaskDialog::SetContent	更新 CTaskDialog的内容。
CTaskDialog::SetDefaultCommandControl	指定默认命令按钮控件。
CTaskDialog::SetDefaultRadioButton	指定默认单选按钮。
CTaskDialog::SetDialogWidth	调整 CTaskDialog的宽度。
CTaskDialog::SetExpansionArea	更新 CTaskDialog的展开区域。
CTaskDialog::SetFooterIcon	更新 CTaskDialog的页脚图标。
CTaskDialog::SetFooterText	更新在 CTaskDialog的页脚的文本。
CTaskDialog::SetMainIcon	更新 CTaskDialog的主要图标。
CTaskDialog::SetMainInstruction	更新 CTaskDialog的主要命令。
CTaskDialog::SetOptions	配置 CTaskDialog的选项。
CTaskDialog::SetProgressBarMarquee	配置 CTaskDialog 的一个marquee栏并将其添加到对话框。
CTaskDialog::SetProgressBarPosition	调整进度栏的位置。
CTaskDialog::SetProgressBarRange	调整进度栏的大小。
CTaskDialog::SetProgressBarState	设置进度栏的状态并将其显示在 CTaskDialog。
CTaskDialog::SetRadioButtonOptions	启用或禁用单选按钮。
CTaskDialog::SetVerificationCheckbox	设置验证复选框中选中状态。
CTaskDialog::SetVerificationCheckboxText	在验证复选框右侧的设置文本。
CTaskDialog::SetWindowTitle	设置 CTaskDialog的标题。
CTaskDialog::ShowDialog	创建并显示 CTaskDialog。
CTaskDialog::TaskDialogCallback	框架调用此响应各种Windows消息。

数据成员

m_aButtons	CTaskDialog的命令按钮控件。
m_aRadioButtons	CTaskDialog的单选按钮控件。
m_bVerified	TRUE 指示验证复选框处于选中状态; FALSE 指示未启用。
m_footerIcon	在 CTaskDialog的页脚的图标。
m_hWnd	一个句柄 CTaskDialog的窗口。
m_mainIcon	CTaskDialog的主要图标。
m_nButtonDisabled	指示掩码哪些常见会禁用按钮。
m_nButtonElevation	指示掩码哪些常见按钮需要UAC特权提升。
m_nButtonId	选定的命令按钮控件的ID。
m_nCommonButton	指示掩码哪些常见的按钮。CTaskDialog显示。
m_nDefaultCommandControl	选中命令按钮控件的ID，当 CTaskDialog 显示。
m_nDefaultRadioButton	选中单选按钮控件的ID，当 CTaskDialog 显示。
m_nFlags	指示 CTaskDialog的选项掩码。
m_nProgressPos	进度栏的当前位置。该值必须介于 m_nProgressRangeMin 和 m_nProgressRangeMax 之间。
m_nProgressRangeMax	进度栏的最大值。
m_nProgressRangeMin	进度栏的最小值。
m_nProgressState	进度栏的状态。有关更多信息，请参见 CTaskDialog::SetProgressBarState。
m_nRadioId	选定的单选按钮控件的ID。
m_nWidth	CTaskDialog 的宽度（以像素为单位）。
m_strCollapse	CTaskDialog 在展开框右侧显示的字符串，在展开的信息隐藏。
m_strContent	CTaskDialog的内容字符串。
m_strExpand	CTaskDialog 在展开框右侧显示的字符串，在展开的信息显示。
m_strFooter	CTaskDialog的页脚。
m_strInformation	CTaskDialog的扩展的信息。
m_strMainInstruction	CTaskDialog的主要命令。
m_strTitle	CTaskDialog 的标题。
m_strVerification	CTaskDialog 在验证复选框右侧显示的字符串。

备注

CTaskDialog 选件类替换标准Windows消息框并具有其他功能(例如收集来自用户的信息的新控件。此选件类在 Visual Studio 2010的MFC库中。CTaskDialog 可用从开始 Windows Vista。Windows的早期版本无法显示 CTaskDialog 对象。使用 CTaskDialog::IsSupported 确定运行时当前用户是否可以显示任务对话框。标准Windows消息框。Visual Studio 2010仍支持。

使用Unicode库时，因此，只有当您生成应用程序 CTaskDialog 可用。

CTaskDialog 有两种不同的构造函数。构造函数可以指定两个命令按钮和更多六个普通按钮控件。在创建 CTaskDialog后，可以添加更多命令按钮。第二个构造函数不支持任何命令按钮，但是，您可以添加数量没有限制的普通按钮控件。有关构造的更多信息，请参见 CTaskDialog::CTaskDialog。

下图显示示例 CTaskDialog 说明中的某些位置控件。

CTaskDialog示例

要求

**最少量必需的操作系统:**Windows Vista

标头: afxtaskdialog.h

请参见

任务

演练:CTaskDialog添加到应用程序

参考

CObject选件类

层次结构图

其他资源

MFC 类