次の方法で共有

CTaskDialog::SetOptions

  • [アーティクル]

CTaskDialog のオプションを構成します。

void SetOptions(
   int nOptionFlag
);

パラメーター

  • [入力] nOptionFlag
    CTaskDialog に対して使用するフラグのセット。

解説

このメソッドは、CTaskDialog の現在のオプションをすべてクリアします。 現在のオプションを保持する場合は、最初にそれらのオプションを CTaskDialog::GetOptions で取得してから、設定するオプションと結合する必要があります。

次の表に、すべての有効なオプションを示します。

  • TDF_ENABLE_HYPERLINKS
    CTaskDialog のハイパーリンクを有効にします。

  • TDF_USE_HICON_MAIN
    メイン アイコンに HICON を使用するよう CTaskDialog を構成します。 代替手段として、LPCWSTR を使用できます。

  • TDF_USE_HICON_FOOTER
    フッター アイコンに HICON を使用するよう CTaskDialog を構成します。 代替手段として、LPCWSTR を使用できます。

  • TDF_ALLOW_DIALOG_CANCELLATION
    [キャンセル] ボタンが有効でない場合でも、ユーザーがキーボードまたはダイアログ ボックスの右上隅のアイコンを使用して CTaskDialog を閉じることができるようにします。 このフラグが設定されていないと、[キャンセル] ボタンが有効でない場合、ユーザーは Alt + F4 キー、Esc キー、およびタイトル バーの閉じるボタンを使用してダイアログ ボックスを閉じることができません。

  • TDF_USE_COMMAND_LINKS
    コマンド ボタン コントロールを使用するように CTaskDialog を構成します。

  • TDF_USE_COMMAND_LINKS_NO_ICON
    コントロールの横にアイコンを表示せずにコマンド ボタン コントロールを使用するように CTaskDialog を構成します。 TDF_USE_COMMAND_LINKS は TDF_USE_COMMAND_LINKS_NO_ICON をオーバーライドします。

  • TDF_EXPAND_FOOTER_AREA
    展開領域が現在展開されていることを示します。

  • TDF_EXPANDED_BY_DEFAULT
    展開領域が既定で展開されるかどうかを判断します。

  • TDF_VERIFICATION_FLAG_CHECKED
    確認のチェック ボックスが現在オンになっていることを示します。

  • TDF_SHOW_PROGRESS_BAR
    プログレス バーを表示するように CTaskDialog を構成します。

  • TDF_SHOW_MARQUEE_PROGRESS_BAR
    プログレス バーをマーキー プログレス バーとして構成します。 このオプションを有効にする場合、期待どおりの結果を得るためには、TDF_SHOW_PROGRESS_BAR を設定する必要があります。

  • TDF_CALLBACK_TIMER
    CTaskDialog のコールバック間隔が約 200 ミリ秒に設定されることを示します。

  • TDF_POSITION_RELATIVE_TO_WINDOW
    親ウィンドウに対して中央に表示されるよう CTaskDialog を構成します。 このフラグが有効でない場合、CTaskDialog はモニターに対して中央に表示されます。

  • TDF_RTL_LAYOUT
    CTaskDialog を右から左に読み取るレイアウトに構成します。

  • TDF_NO_DEFAULT_RADIO_BUTTON
    CTaskDialog が表示されるときにどのオプション ボタンも選択されていないことを示します。

  • TDF_CAN_BE_MINIMIZED
    ユーザーが CTaskDialog を最小化できるようにします。 このオプションをサポートする場合、CTaskDialog をモーダルにはできません。 MFC ではモードレスの CTaskDialog をサポートしていないため、このオプションはサポートされません。

使用例

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

必要条件

**ヘッダー:**afxtaskdialog.h

参照

参照

CTaskDialog クラス

階層図

CTaskDialog::GetOptions