CTaskDialog::CTaskDialog

Articolo
06/10/2015

Crea un'istanza della classe 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("")
);

Parametri

[in] strContent
La stringa da utilizzare per il contenuto CTaskDialog.
[in] strMainInstruction
l'istruzione principale CTaskDialog.
[in] strTitle
Titolo della classe CTaskDialog.
[in] nCommonButtons
Una maschera comuni i pulsanti per aggiungere a CTaskDialog.
[in] nTaskDialogOptions
Set di opzioni utilizzare per CTaskDialog.
[in] strFooter
La stringa da utilizzare come il piè di pagina.
[in] nIDCommandControlsFirst
ID stringa del primo comando.
[in] nIDCommandControlsLast
ID stringa dell'ultimo comando.

Note

Esistono due modi per aggiungere CTaskDialog all'applicazione. La prima consiste nell'utilizzare uno dei costruttori per creare CTaskDialog e visualizzare utilizzando CTaskDialog::DoModal. La seconda modalità è utilizzare la funzione statica CTaskDialog::ShowDialog, che consente di visualizzare CTaskDialog senza creare esplicitamente un oggetto CTaskDialog.

Il secondo costruttore crea pulsanti di comando utilizzando i dati del file di risorse dell'applicazione. La tabella di stringhe nel file di risorse sono disponibili diverse stringhe con ID stringa collegata. Questo metodo aggiunge un pulsante di comando per ciascuna voce valida nella tabella di stringhe tra nIDCommandControlsFirst e nCommandControlsLast, inclusi. Per questi pulsanti di comando, la stringa nella tabella di stringhe è la barra del titolo del controllo e ID stringa è l'id del controllo

Vedere CTaskDialog::SetOptions per un elenco di opzioni valide.

Esempio

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