CTaskDialog::ShowDialog

项目
03/01/2013

创建并显示 CTaskDialog。

static INT_PTR ShowDialog(
   const CString& strContent,
   const CString& strMainInstruction,
   const CString& strTitle,
   int nIDCommandControlsFirst,
   int nIDCommandControlsLast,
   int nCommonButtons = TDCBF_YES_BUTTON | TDCBF_NO_BUTTON,
   int nTaskDialogOptions = TDF_ENABLE_HYPERLINKS | TDF_USE_COMMAND_LINKS,
   const CString& strFooter = _T("")
);

参数

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

返回值

对应于选定内容的整数由用户进行。

备注

此静态方法使您可以创建 CTaskDialog类选件的实例，而无需显式创建 CTaskDialog 对象在您的代码。由于没有 CTaskDialog 对象，则无法调用 CTaskDialog 的任何其他方法，如果使用此方法 CTaskDialog 显示给用户。

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

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

当用户选择一个常见按钮，命令链接控件或关闭 CTaskDialog，CTaskDialog 关闭。返回值是指示的标识符用户如何关闭对话框。

示例

    // TODO: Replace the string below with the actual message to the user
    CString message("Important information to the user");
    // TODO: Replace the string below with the title of this project
    CString title("Project Title");

    CString emptyString;

    if (CTaskDialog::IsSupported())
    {
        CTaskDialog::ShowDialog(message, emptyString, title, 0, 0, 
            TDCBF_OK_BUTTON);
    }
    else
    {
        AfxMessageBox(message);
    }