CTaskDialog::SetFooterIcon

Artikel
02/26/2013

Aktualisiert das Fußzeilensymbol CTaskDialog.

void SetFooterIcon(
   HICON hFooterIcon
);

void SetFooterIcon(
   LPCWSTR lpszFooterIcon
);

Parameter

[in] hFooterIcon
Das neue Symbol für CTaskDialog.
[in] lpszFooterIcon
Das neue Symbol für CTaskDialog.

Hinweise

Das Fußzeilensymbol wird am Ende der CTaskDialog-Klasse angezeigt.Es kann Fußzeilentext zugeordnet haben.Sie können den Fußzeilentext mit CTaskDialog::SetFooterText ändern.

Diese Methode löst eine Ausnahme mit dem STELLEN SEH SICHER (MFC)-Makro aus, wenn CTaskDialog angezeigt wird, oder der Eingabeparameter NULL ist.

CTaskDialog kann HICON oder LPCWSTR als Fußzeilensymbol nur akzeptieren.Dies wird konfiguriert, indem die Option TDF_USE_HICON_FOOTER im Konstruktor oder in CTaskDialog::SetOptions festgelegt wird.Standardmäßig wird CTaskDialog konfiguriert, um LPCWSTR als der Eingabetyp für das Fußzeilensymbol zu verwenden.Diese Methode wird eine Ausnahme generiert, wenn Sie versuchen, das Symbol mithilfe des falschen Typs festzulegen.

Beispiel

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