STM_SETIMAGE message

Une application envoie un message STM_SETIMAGE pour associer une nouvelle image à un contrôle statique.

Paramètres

wParam

Spécifie le type d’image à associer au contrôle statique. Ce paramètre peut être l’une des valeurs suivantes :

Valeur Signification
IMAGE_BITMAP
Bitmap.
IMAGE_CURSOR
Curseur.
IMAGE_ENHMETAFILE
Métafichier amélioré.
IMAGE_ICON
Icône.

lParam

Gérez l’image à associer au contrôle statique.

Valeur retournée

La valeur de retour est un handle de l’image précédemment associée au contrôle statique, le cas échéant ; sinon, elle est NULL.

Notes

Pour associer une image à un contrôle statique, le contrôle doit avoir le style approprié. Le tableau suivant montre le style nécessaire pour chaque type d’image.

Type d’image Style de contrôle statique
IMAGE_BITMAP SS_BITMAP
IMAGE_CURSOR SS_ICON
IMAGE_ENHMETAFILE SS_ENHMETAFILE
IMAGE_ICON SS_ICON

Important

Dans la version 6 des contrôles Microsoft Win32, une bitmap passée à un contrôle statique à l’aide du message STM_SETIMAGE était la même bitmap retournée par un message STM_SETIMAGE suivant. Le client est chargé de supprimer toute bitmap envoyée à un contrôle statique.

Avec Windows XP, si la bitmap passée dans le message STM_SETIMAGE contient des pixels avec une valeur alpha différente de zéro, le contrôle statique prend une copie de la bitmap. Cette bitmap copiée est retournée par le message STM_SETIMAGE suivant. Le code client peut suivre indépendamment les bitmaps passées au contrôle statique, mais s’il n’case activée pas et libère les bitmaps retournées par STM_SETIMAGE messages, les bitmaps sont divulguées.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2003 [applications de bureau uniquement]
En-tête
Winuser.h (inclure Windows.h)

Voir aussi

STM_GETIMAGE