CTaskDialog::CTaskDialog

Article
03/04/2013

Crée une instance de De classe CTaskDialog.

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

Paramètres

[in] strContent
La chaîne à utiliser pour le contenu d' CTaskDialog.
[in] strMainInstruction
l'instruction principale d' CTaskDialog.
[in] strTitle
Titre de la CTaskDialog.
[in] nCommonButtons
Un masque de communs boutons pour ajouter à CTaskDialog.
[in] nTaskDialogOptions
L'ensemble d'options à utiliser pour CTaskDialog.
[in] strFooter
La chaîne à utiliser comme pied de page.
[in] nIDCommandControlsFirst
L'ID de chaîne de la première commande.
[in] nIDCommandControlsLast
L'ID de chaîne de la dernière commande.

Notes

Il existe deux façons d'ajouter CTaskDialog à votre application.La première consiste à utiliser l'un des constructeurs pour créer CTaskDialog et l'afficher à l'aide de CTaskDialog::DoModal.La seconde méthode consiste à utiliser la fonction statique CTaskDialog::ShowDialog, qui vous permet d'afficher CTaskDialog sans créer explicitement un objet d' CTaskDialog .

Le deuxième constructeur crée des contrôles de bouton de commande à l'aide de les données du fichier de ressources de votre application.La table de chaînes dans le fichier de ressources a plusieurs chaînes avec les ID associés de chaîne.Cette méthode ajoute un contrôle bouton de commande pour chaque entrée valide dans la table de chaînes entre nIDCommandControlsFirst et nCommandControlsLast, inclus.Pour ces contrôles bouton de commande, la chaîne dans la table de chaînes est la légende du contrôle et l'ID de chaîne est l'ID du contrôle

Consultez CTaskDialog::SetOptions pour une liste d'options valides.

Exemple

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