CTaskDialog::CTaskDialog

Artículo
06/10/2015

Crea una instancia de CTaskDialog Class.

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
La cadena que se va a usar para el contenido de CTaskDialog.
[in] strMainInstruction
la instrucción principal de CTaskDialog.
[in] strTitle
Título de la página CTaskDialog.
[in] nCommonButtons
una máscara de los botones comunes a agregar a CTaskDialog.
[in] nTaskDialogOptions
el conjunto de opciones de utilizar para CTaskDialog.
[in] strFooter
La cadena que se utilizará como el pie de página.
[in] nIDCommandControlsFirst
El identificador de cadena del primer comando.
[in] nIDCommandControlsLast
El identificador de cadena de comando pasado.

Comentarios

Hay dos maneras de agregar CTaskDialog a la aplicación. La primera consiste en usar uno de los constructores para crear CTaskDialog y mostrarlo utilizando CTaskDialog::DoModal. La segunda consiste en utilizar la función estática CTaskDialog::ShowDialog, que permite mostrar CTaskDialog sin crear explícitamente un objeto de CTaskDialog .

El segundo constructor crea los controles de Botón de comando utilizando los datos del archivo de recursos de la aplicación. la tabla de cadenas en el archivo de recursos tiene varias cadenas con id. asociado de la cadena. Este método agrega un control de Botón de comando para cada entrada válida de la tabla de cadenas entre nIDCommandControlsFirst y nCommandControlsLast, incluidos. Para estos controles de Botón de comando, la cadena en la tabla de cadenas es la leyenda del control y el identificador de cadena es el identificador de control

Vea CTaskDialog::SetOptions para una lista de opciones válidas.

Ejemplo

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