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 |
|