CTaskDialog::CTaskDialog

Článek
03/04/2013

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

Parametry

[v]strContent
Řetězec pro obsah CTaskDialog .
[v]strMainInstruction
Hlavní instrukce o CTaskDialog .
[v]strTitle
Název CTaskDialog .
[v]nCommonButtons
Maska společné tlačítka Přidat CTaskDialog .
[v]nTaskDialogOptions
Nastavení voleb pro použití CTaskDialog .
[v]strFooter
Řetězec jako zápatí.
[v]nIDCommandControlsFirst
Řetězec ID první příkaz.
[v]nIDCommandControlsLast
Řetězec ID poslední příkaz.

Poznámky

Existují dva způsoby, které lze přidat CTaskDialog aplikace.První způsob je jeden konstruktory používat k vytváření CTaskDialog a zobrazení pomocí CTaskDialog::DoModal.Druhým způsobem je použití statické funkce CTaskDialog::ShowDialog, který umožňuje zobrazit CTaskDialog bez vytvoření explicitně CTaskDialog objektu.

Druhý konstruktor vytvoří ovládací prvky příkazového tlačítka pomocí dat ze zdrojového souboru aplikace.Tabulky řetězců v souboru prostředků má několik řetězců s ID přidružené řetězec.Tato metoda přidá příkazové tlačítko pro každou platnou položku v tabulce řetězců mezi nIDCommandControlsFirst a nCommandControlsLast , včetně.Pro tyto ovládací prvky příkazového tlačítka řetězec v tabulce řetězců je titulek ovládacího prvku, a řetězec ID ID ovládacího prvku.

Viz CTaskDialog::SetOptions seznam obsahuje platné možnosti.

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