CTaskDialog::SetOptions
設定 CTaskDialog的選項。
void SetOptions(
int nOptionFlag
);
參數
- [in] nOptionFlag
使用的一組旗標 CTaskDialog。
備註
這個方法會清除 CTaskDialog的所有目前選取。 若要儲存目前選項，您必須先擷取它們與 CTaskDialog::GetOptions 和合併它們與您要設定的選項。
下表列出所有有效的選擇。
TDF_ENABLE_HYPERLINKS
啟用 CTaskDialog的超連結。TDF_USE_HICON_MAIN
設定 CTaskDialog 的主要圖示使用 HICON 。 這個選項是使用 LPCWSTR。TDF_USE_HICON_FOOTER
設定 CTaskDialog 指定頁尾圖示使用 HICON 。 這個選項是使用 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， MFC 不支援這個選項。
範例
// 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