сообщение 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 установлен в элементе dwFlags структуры TASKDIALOGCONFIG , используемой для создания диалогового окна задачи, lParam должен содержать дескриптор значка (HICON) для отображения.

Если значение wParam равно TDIE_ICON_FOOTER, а флаг TDF_USE_HICON_FOOTER установлен в элементе dwFlags структуры TASKDIALOGCONFIG , используемой для создания диалогового окна задачи, lParam должен содержать дескриптор значка (HICON) для отображения.

Если флаги TDF_USE_HICON_MAIN или TDF_USE_HICON_FOOTER не заданы в элементе dwFlags , lParam должен указывать на строку Юникода ( PCWSTR), которая содержит допустимый идентификатор ресурса, передаваемый через макрос MAKEINTRESOURCE . Значок отображается на основе значения wParam: если значение TDIE_ICON_MAIN, значок отображается в заголовке ; Если значение равно TDIE_ICON_FOOTER, значок отображается в нижнем колонтитуле. Ресурс должен быть либо из модуля ресурсов приложения (указанного в элементе hInstance структуры TASKDIALOGCONFIG ), либо, если параметр 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