mensaje de STM_SETIMAGE

Una aplicación envía un mensaje de STM_SETIMAGE para asociar una nueva imagen a un control estático.

Parámetros

wParam

Especifica el tipo de imagen que se va a asociar al control estático. Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
IMAGE_BITMAP	Bits.
IMAGE_CURSOR	Cursor.
IMAGE_ENHMETAFILE	Metarchivo mejorado.
IMAGE_ICON	Icono.

lParam

Identificador de la imagen que se va a asociar al control estático.

Valor devuelto

El valor devuelto es un identificador de la imagen asociada previamente con el control estático, si existe; de lo contrario, es NULL.

Comentarios

Para asociar una imagen a un control estático, el control debe tener el estilo adecuado. En la tabla siguiente se muestra el estilo necesario para cada tipo de imagen.

Tipo de imagen	Estilo de control estático
IMAGE_BITMAP	SS_BITMAP
IMAGE_CURSOR	SS_ICON
IMAGE_ENHMETAFILE	SS_ENHMETAFILE
IMAGE_ICON	SS_ICON

Importante

En la versión 6 de los controles de Microsoft Win32, un mapa de bits pasado a un control estático mediante el STM_SETIMAGE mensaje era el mismo mapa de bits devuelto por un mensaje de STM_SETIMAGE posterior. El cliente es responsable de eliminar cualquier mapa de bits enviado a un control estático.

Con Windows XP, si el mapa de bits pasado en el STM_SETIMAGE mensaje contiene píxeles con alfa distinto de cero, el control estático toma una copia del mapa de bits. El siguiente mensaje de STM_SETIMAGE devuelve este mapa de bits copiado. El código de cliente puede realizar un seguimiento independiente de los mapas de bits pasados al control estático, pero si no comprueba y libera los mapas de bits devueltos de STM_SETIMAGE mensajes, se filtran los mapas de bits.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windows.h)

Consulte también

STM_GETIMAGE