CTaskDialog::CTaskDialog

Artigo
02/25/2013

Cria uma instância de Classe de 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("")
);

Parâmetros

[in] strContent
A cadeia de caracteres a ser usado para o conteúdo de CTaskDialog.
[in] strMainInstruction
a instrução principal de CTaskDialog.
[in] strTitle
o título de CTaskDialog.
[in] nCommonButtons
Uma máscara comuns para adicionar botões a CTaskDialog.
[in] nTaskDialogOptions
O conjunto de opções para usar CTaskDialog.
[in] strFooter
A cadeia de caracteres para usar como o rodapé.
[in] nIDCommandControlsFirst
A identificação de cadeia de caracteres do primeiro comando.
[in] nIDCommandControlsLast
A identificação de cadeia de caracteres de comando do último.

Comentários

Há duas maneiras que você pode adicionar CTaskDialog ao seu aplicativo.A primeira maneira é usar um dos construtores para criar CTaskDialog e exibi-la que usa CTaskDialog::DoModal.A segunda maneira é usar a função CTaskDialog::ShowDialogestático, que permite que você exiba CTaskDialog sem criar explicitamente um objeto de CTaskDialog .

O segundo construtor cria controles de botão de comando usando dados do arquivo de recurso do aplicativo.A tabela de cadeia de caracteres no arquivo de recurso tem várias cadeias de caracteres com os IDs associados de cadeia de caracteres.Este método adiciona um controle de botão de comando para cada entrada válida na tabela de cadeia de caracteres entre nIDCommandControlsFirst e nCommandControlsLast, inclusive.Para esses controles de botão de comando, a cadeia de caracteres na tabela de cadeia de caracteres é a legenda do controle e a identificação de cadeia de caracteres é a identificação do controle

Consulte CTaskDialog::SetOptions para obter uma lista de opções válidos.

Exemplo

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