TDM_UPDATE_ICON消息

刷新任务对话框的图标。

参数

wParam [in]

指示要更新的图标元素。 此参数必须是以下值之一：

值	含义
TDIE_ICON_MAIN	主图标。
TDIE_ICON_FOOTER	页脚图标。

lParam [in]

指向 PCWSTR (字符串的指针) 或句柄，该图标 (HICON) 显示。 如果 lParam 为 NULL，则不显示任何图标，而不考虑 wParam 的值。

如果 wParam 的值TDIE_ICON_MAIN并且TDF_USE_HICON_MAIN标志是在用于创建任务对话框的 TASKDIALOGCONFIG 结构的 dwFlags 成员上设置的，则 lParam 必须包含图标的句柄， (HICON) 显示。

如果 wParam 的值TDIE_ICON_FOOTER并且TDF_USE_HICON_FOOTER标志是在用于创建任务对话框的 TASKDIALOGCONFIG 结构的 dwFlags 成员上设置的，则 lParam 必须包含一个图标句柄， (HICON) 显示。

如果未在 dwFlags 成员上设置TDF_USE_HICON_MAIN或TDF_USE_HICON_FOOTER标志，则 lParam 必须指向以 null 结尾的 Unicode 字符串 (PCWSTR) ，其中包含通过 MAKEINTRESOURCE 宏传递的有效资源标识符。 图标基于 wParam 的值显示：如果值TDIE_ICON_MAIN，则图标显示在标题中;如果值为 TDIE_ICON_FOOTER，则图标显示在页脚中。 资源必须来自应用程序的资源模块 (TASKDIALOGCONFIG 结构) 的 hInstance 成员中指定的，或者如果 hInstance 为 NULL，则来自系统的资源模块 (imageres.dll) 。 若要标识系统资源，请使用通过 MAKEINTRESOURCE 宏传递的有效系统标识符或来自 commctrl.h 的以下预定义值之一：

值	含义
TD_ERROR_ICON	停止标志图标。
TD_WARNING_ICON	感叹号图标。
TD_INFORMATION_ICON	圆圈图标中的小写字母“i”。
TD_SHIELD_ICON	安全防护图标。

返回值

忽略返回值。

备注

带有 图标的任务对话框的布局可能会失败，并且可能不会反映在返回值中。 返回值 S_OK 仅反映任务对话框收到消息并尝试处理该消息。 如果任务对话框的布局失败，对话将关闭，并在注册的回调函数处返回 HRESULT 代码。 有关回调函数语法的详细信息，请参阅 TaskDialogCallbackProc。

如果创建任务对话框时没有页脚 (也就是说，用于创建任务对话框的 TASKDIALOGCONFIG 结构的相应页脚成员为 NULL) 并且发送此消息，则不会将页脚动态添加到任务对话。 在创建没有标头的任务对话框时，发送此消息以更新标头图标也是如此。 若要在运行时添加页眉或页脚，请使用 TDM_NAVIGATE_PAGE 功能。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Commctrl.h