CTaskDialog::CTaskDialog

[アーティクル]
08/09/2011

CTaskDialog クラスのインスタンスを作成します。

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("")
);

パラメーター

[入力] strContent
CTaskDialog の内容に使用する文字列。
[入力] strMainInstruction
CTaskDialog のメインの命令。
[入力] strTitle
CTaskDialog のタイトル。
[入力] nCommonButtons
CTaskDialog に追加するコモンボタンのマスク。
[入力] nTaskDialogOptions
CTaskDialog に使用するオプションのセット。
[入力] strFooter
フッターとして使用する文字列。
[入力] nIDCommandControlsFirst
最初のコマンドの文字列 ID。
[入力] nIDCommandControlsLast
最後のコマンドの文字列 ID。

解説

アプリケーションに CTaskDialog を追加するには、2 とおりの方法があります。 1 つは、コンストラクターの 1 つを使用して CTaskDialog を作成し、それを CTaskDialog::DoModal で表示する方法です。もう 1 つは、静的関数の CTaskDialog::ShowDialog を使用する方法です。これにより、CTaskDialog オブジェクトを明示的に作成せずに CTaskDialog を表示できます。

2 番目のコンストラクターで、アプリケーションのリソースファイルのデータを使用して、コマンドボタンコントロールを作成します。リソースファイル内のストリングテーブルには、いくつかの文字列が含まれ、それぞれ文字列 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();