CTaskDialog::SetFooterIcon

Article
06/10/2015

Met à jour l'icône de pied de page d' CTaskDialog.

void SetFooterIcon(
   HICON hFooterIcon
);

void SetFooterIcon(
   LPCWSTR lpszFooterIcon
);

Paramètres

[in] hFooterIcon
La nouvelle icône pour CTaskDialog.
[in] lpszFooterIcon
La nouvelle icône pour CTaskDialog.

Notes

L'icône de pied de page est affichée en bas de CTaskDialog, classe. Elle peut avoir associé le texte de pied de page. Vous pouvez modifier le texte de pied de page avec CTaskDialog::SetFooterText.

Cette méthode lève une exception avec la macro d' GARANTISSEZ (MFC) si CTaskDialog est affiché ou le paramètre d'entrée est NULL.

CTaskDialog peut accepter uniquement HICON ou LPCWSTR en tant qu'icône de pied de page. Cela est configuré en définissant l'option TDF_USE_HICON_FOOTER dans le constructeur ou CTaskDialog::SetOptions. Par défaut, CTaskDialog est configuré pour utiliser LPCWSTR comme type d'entrée pour l'icône de pied de page. Cette méthode génère une exception si vous essayez de définir l'icône à l'aide de le type inapproprié.

Exemple

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