CTaskDialog::CTaskDialog

项目
03/01/2013

CTaskDialog(
   const CString& strContent,
   const CString& strMainInstruction,
   const CString& strTitle,
   int nCommonButtons = TDCBF_OK_BUTTON | TDCBF_CANCEL_BUTTON,
   int nTaskDialogOptions = TDF_ENABLE_HYPERLINKS | TDF_USE_COMMAND_LINKS,
   const CString& strFooter = _T("")
);

CTaskDialog(
   const CString& strContent,
   const CString& strMainInstruction,
   const CString& strTitle,
   int nIDCommandControlsFirst,
   int nIDCommandControlsLast,
   int nCommonButtons,
   int nTaskDialogOptions = TDF_ENABLE_HYPERLINKS | TDF_USE_COMMAND_LINKS,
   const CString& strFooter = _T("")
);

参数

[in] strContent
使用的字符串。CTaskDialog的内容。
[in] strMainInstruction
CTaskDialog的主要命令。
[in] strTitle
CTaskDialog 的标题。
[in] nCommonButtons
常见的掩码按添加到 CTaskDialog。
[in] nTaskDialogOptions
设置选项。CTaskDialog使用。
[in] strFooter
使用的字符串作为页脚。
[in] nIDCommandControlsFirst
第一个指令的字符串ID。
[in] nIDCommandControlsLast
最后一个命令的字符串ID。

备注

有两种方法可以添加 CTaskDialog 到您的应用程序。使用 CTaskDialog::DoModal，第一种方法是使用构造函数之一创建 CTaskDialog 并显示它。第二种方法是使用静态函数 CTaskDialog::ShowDialog，可以显示 CTaskDialog，而无需显式创建 CTaskDialog 对象。

第二个构造函数创建命令按钮控件使用数据从应用程序资源文件。在资源文件中的字符串表与关联的字符串ID的几个字符串。此方法将每个有效项的命令按钮控件在 nIDCommandControlsFirst 和 nCommandControlsLast之间的字符串表中，包含。对于这些命令按钮控件，在字符串表中的控件的声明，并字符串ID为的控件的ID.

为有效选项列表参见 CTaskDialog::SetOptions。

示例

// TODO: Replace the strings below with the appropriate message, 
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");

CTaskDialog taskDialog(message, mainInstruction, title, 
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );

// Setting new information to be able to reuse the dialog resource
taskDialog.SetWindowTitle(L"New title for the task dialog");
taskDialog.SetContent(L"New message to show the user.");
taskDialog.SetMainInstruction(L"Even more important!");
taskDialog.SetMainIcon(TD_ERROR_ICON);
taskDialog.SetDialogWidth(300);

// Add a footer
taskDialog.SetFooterText(L"Footer information for the dialog.");
taskDialog.SetFooterIcon(TD_INFORMATION_ICON);

// Add expansion information
taskDialog.SetExpansionArea(L"Additional information\non two lines.",
    L"Click here for more information.",
    L"Click here to hide the extra information.");

// Change the options to show the expanded information by default.
// It is necessary to retrieve the current options first.
int options = taskDialog.GetOptions();
options |= TDF_EXPANDED_BY_DEFAULT;
taskDialog.SetOptions(options);

taskDialog.DoModal();