mensaje de TDM_UPDATE_ICON

Actualiza el icono de un cuadro de diálogo de tarea.

Parámetros

wParam [in]

Indica qué elemento de icono se va a actualizar. Este parámetro debe ser uno de los siguientes valores:

Valor	Significado
TDIE_ICON_MAIN	Icono principal.
TDIE_ICON_FOOTER	Icono de pie de página.

lParam [in]

Puntero a una cadena (PCWSTR) o identificador a un icono (HICON) que se va a mostrar. Si lParam es NULL, no se muestra ningún icono, independientemente del valor de wParam.

Si el valor de wParam es TDIE_ICON_MAIN y la marca TDF_USE_HICON_MAIN se establece en el miembro dwFlags de la estructura TASKDIALOGCONFIG utilizada para crear el cuadro de diálogo de tarea, lParam debe contener un identificador para un icono (HICON) que se va a mostrar.

Si el valor de wParam es TDIE_ICON_FOOTER y la marca TDF_USE_HICON_FOOTER se establece en el miembro dwFlags de la estructura TASKDIALOGCONFIG utilizada para crear el cuadro de diálogo de tarea, lParam debe contener un identificador para un icono (HICON) que se va a mostrar.

Si las marcas TDF_USE_HICON_MAIN o TDF_USE_HICON_FOOTER no están establecidas en el miembro dwFlags , lParam debe apuntar a una cadena Unicode terminada en null (PCWSTR) que contenga un identificador de recurso válido pasado a través de la macro MAKEINTRESOURCE . El icono se muestra en función del valor de wParam: si el valor es TDIE_ICON_MAIN, el icono se muestra en el encabezado; Si el valor es TDIE_ICON_FOOTER, el icono se muestra en el pie de página. El recurso debe ser del módulo de recursos de la aplicación (especificado en el miembro hInstance de la estructura TASKDIALOGCONFIG ), o si hInstance es NULL, desde el módulo de recursos del sistema (imageres.dll). Para identificar un recurso del sistema, use un identificador de sistema válido pasado a través de la macro MAKEINTRESOURCE o uno de los siguientes valores predefinidos de commctrl.h:

Valor	Significado
TD_ERROR_ICON	Icono de signo de detención.
TD_WARNING_ICON	Icono de signo de exclamación.
TD_INFORMATION_ICON	Una letra minúscula "i" en un icono de círculo.
TD_SHIELD_ICON	Un icono de escudo de seguridad.

Valor devuelto

Se omite el valor devuelto.

Comentarios

Es posible que se produzca un error en el diseño del cuadro de diálogo de tareas con el icono y que esto no se refleje en el valor devuelto. Un valor devuelto de S_OK solo refleja que el cuadro de diálogo de tarea recibió el mensaje e intentó procesarlo. Si se produce un error en el diseño del cuadro de diálogo de tarea, se cerrará el diálogo y se devolverá un código HRESULT en la función de devolución de llamada registrada. Para obtener más información sobre la sintaxis de la función de devolución de llamada, vea TaskDialogCallbackProc.

Si el cuadro de diálogo de tarea se crea sin un pie de página (es decir, los miembros de pie de página adecuados de la estructura TASKDIALOGCONFIG que se usa para crear el cuadro de diálogo de tareas son NULL) y se envía este mensaje, un pie de página no se agrega dinámicamente al cuadro de diálogo de tarea. Lo mismo sucede para enviar este mensaje para actualizar un icono de encabezado cuando se crea un cuadro de diálogo de tarea sin un encabezado. Para agregar un encabezado o pie de página en tiempo de ejecución, use la funcionalidad TDM_NAVIGATE_PAGE .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h