CTaskDialog::SetFooterIcon

Artículo
06/10/2015

Actualiza el icono de pie de página de CTaskDialog.

void SetFooterIcon(
   HICON hFooterIcon
);

void SetFooterIcon(
   LPCWSTR lpszFooterIcon
);

Parámetros

[in] hFooterIcon
el nuevo icono para CTaskDialog.
[in] lpszFooterIcon
el nuevo icono para CTaskDialog.

Comentarios

El icono de pie de página se muestra en la parte inferior de CTaskDialog Class. Puede tener texto del pie de página asociado. Puede cambiar el texto del pie de página con CTaskDialog::SetFooterText.

Este método produce una excepción con la macro de ENSURE (MFC) si se muestra CTaskDialog o el parámetro de entrada es NULL.

CTaskDialog sólo puede aceptar HICON o LPCWSTR como icono de pie de página. esto es configurada estableciendo la opción TDF_USE_HICON_FOOTER en el constructor o CTaskDialog::SetOptions. De forma predeterminada, CTaskDialog se configura para utilizar LPCWSTR como entrada escrita para el icono de pie de página. Este método genera una excepción si intenta establecer el icono mediante el tipo inadecuado.

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