Export (0) Print
Expand All
MFC
Expand Minimize

CTaskDialog::SetOptions

Configures the options for the CTaskDialog.

void SetOptions(
   int nOptionFlag
);

[in] nOptionFlag

The set of flags to use for the CTaskDialog.

This method clears all the current options for the CTaskDialog. To preserve the current options, you must retrieve them first with CTaskDialog::GetOptions and combine them with the options that you want to set.

The following table lists all the valid options.

TDF_ENABLE_HYPERLINKS

Enables hyperlinks in the CTaskDialog.

TDF_USE_HICON_MAIN

Configures the CTaskDialog to use a HICON for the main icon. The alternative is to use a LPCWSTR.

TDF_USE_HICON_FOOTER

Configures the CTaskDialog to use a HICON for the footer icon. The alternative is to use a LPCWSTR.

TDF_ALLOW_DIALOG_CANCELLATION

Enables the user to close the CTaskDialog by using the keyboard or by using the icon in the upper-right corner of the dialog box, even if the Cancel button is not enabled. If this flag is not set and the Cancel button is not enabled, the user cannot close the dialog box by using Alt+F4, the Escape key, or the title bar's close button.

TDF_USE_COMMAND_LINKS

Configures the CTaskDialog to use command button controls.

TDF_USE_COMMAND_LINKS_NO_ICON

Configures the CTaskDialog to use command button controls without displaying an icon next to the control. TDF_USE_COMMAND_LINKS overrides TDF_USE_COMMAND_LINKS_NO_ICON.

TDF_EXPAND_FOOTER_AREA

Indicates the expansion area is currently expanded.

TDF_EXPANDED_BY_DEFAULT

Determines whether the expansion area is expanded by default.

TDF_VERIFICATION_FLAG_CHECKED

Indicates the verification check box is currently selected.

TDF_SHOW_PROGRESS_BAR

Configures the CTaskDialog to display a progress bar.

TDF_SHOW_MARQUEE_PROGRESS_BAR

Configures the progress bar to be a marquee progress bar. If you enable this option, you must set TDF_SHOW_PROGRESS_BAR to have the expected behavior.

TDF_CALLBACK_TIMER

Indicates that the CTaskDialog callback interval is set to approximately 200 milliseconds.

TDF_POSITION_RELATIVE_TO_WINDOW

Configures the CTaskDialog to be centered relative to the parent window. If this flag is not enabled, the CTaskDialog is centered relative to the monitor.

TDF_RTL_LAYOUT

Configures the CTaskDialog for a right-to-left reading layout.

TDF_NO_DEFAULT_RADIO_BUTTON

Indicates that no radio button is selected when the CTaskDialog appears.

TDF_CAN_BE_MINIMIZED

Enables the user to minimize the CTaskDialog. To support this option, the CTaskDialog cannot be modal. MFC does not support this option because MFC does not support a modeless 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();


Header: afxtaskdialog.h

Community Additions

ADD
Show:
© 2014 Microsoft