CTaskDialog::ShowDialog

Artículo
02/19/2013

Crea y muestra CTaskDialog.

static INT_PTR ShowDialog(
   const CString& strContent,
   const CString& strMainInstruction,
   const CString& strTitle,
   int nIDCommandControlsFirst,
   int nIDCommandControlsLast,
   int nCommonButtons = TDCBF_YES_BUTTON | TDCBF_NO_BUTTON,
   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] nIDCommandControlsFirst
El identificador de cadena del primer comando.
[in] nIDCommandControlsLast
El identificador de cadena de comando pasado.
[in] nCommonButtons
Una máscara de botones 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.

Valor devuelto

Un entero que corresponde a la selección creados por el usuario.

Comentarios

Este método estático permite crear una instancia de Clase CTaskDialog sin crear explícitamente un objeto de CTaskDialog en el código.Dado que no hay ningún objeto de CTaskDialog , no puede llamar a cualquier otro método de CTaskDialog si utiliza este método para mostrar CTaskDialog al usuario.

Este método 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.

CTaskDialog se cierra cuando el usuario selecciona un botón común, un control de vínculo de comando, o cierre CTaskDialog.El valor devuelto es el identificador que indica cómo cerró el usuario.

Ejemplo

    // TODO: Replace the string below with the actual message to the user
    CString message("Important information to the user");
    // TODO: Replace the string below with the title of this project
    CString title("Project Title");

    CString emptyString;

    if (CTaskDialog::IsSupported())
    {
        CTaskDialog::ShowDialog(message, emptyString, title, 0, 0, 
            TDCBF_OK_BUTTON);
    }
    else
    {
        AfxMessageBox(message);
    }