CTaskDialog::SetOptions

Článek
03/04/2013

Konfiguruje parametry CTaskDialog .

void SetOptions(
   int nOptionFlag
);

Parametry

[v]nOptionFlag
Sada příznaků pro použití CTaskDialog .

Poznámky

Tato metoda vymaže aktuální možnosti pro CTaskDialog .Pokud chcete zachovat aktuální možnosti, musíte získat je nejprve s CTaskDialog::GetOptions a jejich kombinací s možností, které chcete nastavit.

V následující tabulce jsou uvedeny platné možnosti.

TDF_ENABLE_HYPERLINKS
Umožňuje hypertextové odkazy CTaskDialog .
TDF_USE_HICON_MAIN
Konfiguruje CTaskDialog použití HICON pro hlavní ikonu.Alternativou je použití LPCWSTR .
TDF_USE_HICON_FOOTER
Konfiguruje CTaskDialog použití HICON pro ikonu zápatí.Alternativou je použití LPCWSTR .
TDF_ALLOW_DIALOG_CANCELLATION
Umožňuje uživateli Zavřít CTaskDialog pomocí klávesnice nebo pomocí ikony v pravém horním rohu dialogového okna i Zrušit tlačítko není povoleno.Pokud není nastaven tento příznak a Zrušit tlačítko není povoleno, uživatel nemůže pomocí klávesy ESC Alt + F4 zavřete dialogové okno nebo tlačítko zavření záhlaví okna.
TDF_USE_COMMAND_LINKS
Konfiguruje CTaskDialog používat ovládací prvky příkazového tlačítka.
TDF_USE_COMMAND_LINKS_NO_ICON
Konfiguruje CTaskDialog používat ovládací prvky příkazového tlačítka bez zobrazení ikony vedle ovládacího prvku.TDF_USE_COMMAND_LINKSpřepíše TDF_USE_COMMAND_LINKS_NO_ICON .
TDF_EXPAND_FOOTER_AREA
Označuje, že rozšíření oblasti je aktuálně rozbalená.
TDF_EXPANDED_BY_DEFAULT
Určuje, zda je ve výchozím nastavení rozbalena rozšíření oblasti.
TDF_VERIFICATION_FLAG_CHECKED
Označuje, že políčko ověřování je aktuálně vybrán.
TDF_SHOW_PROGRESS_BAR
Konfiguruje CTaskDialog zobrazí indikátor průběhu.
TDF_SHOW_MARQUEE_PROGRESS_BAR
Nastaví indikátor průběhu se indikátor průběhu hranice výběru.Pokud povolíte tuto možnost, musíte nastavit TDF_SHOW_PROGRESS_BAR mít očekávané chování.
TDF_CALLBACK_TIMER
Určuje, že CTaskDialog zpětného volání interval je nastaven na přibližně 200 milisekund.
TDF_POSITION_RELATIVE_TO_WINDOW
Konfiguruje CTaskDialog na střed nadřazené okno být.Pokud není tento příznak povolen, CTaskDialog je střed monitoru.
TDF_RTL_LAYOUT
Konfiguruje CTaskDialog rozložení čtení zprava doleva.
TDF_NO_DEFAULT_RADIO_BUTTON
Označuje, že není vybrán přepínač při CTaskDialog se zobrazí.
TDF_CAN_BE_MINIMIZED
Umožňuje uživateli minimalizovat CTaskDialog .Podporu této možnosti CTaskDialog nemůže být modální.MFC nepodporuje tuto možnost, protože MFC nepodporuje nemodální CTaskDialog .

Příklad

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

Požadavky

Záhlaví: afxtaskdialog.h

Viz také

Referenční dokumentace

Třída CTaskDialog

Diagram hierarchie

CTaskDialog::GetOptions

Sdílet prostřednictvím