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