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 |
|
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour