STM_SETIMAGE Nachricht
Eine Anwendung sendet eine STM_SETIMAGE Nachricht, um einem statischen Steuerelement ein neues Bild zuzuordnen.
Parameter
-
wParam
-
Gibt den Typ des Bilds an, das dem statischen Steuerelement zugeordnet werden soll. Dieser Parameter kann einer der folgenden Werte sein:
Wert Bedeutung - IMAGE_BITMAP
Bitmap. - IMAGE_CURSOR
Cursor. - IMAGE_ENHMETAFILE
Erweiterte Metadatei. - IMAGE_ICON
Symbol. -
lParam
-
Handle für das Bild, das dem statischen Steuerelement zugeordnet werden soll.
Rückgabewert
Der Rückgabewert ist ein Handle für das Bild, das zuvor dem statischen Steuerelement zugeordnet ist, sofern vorhanden. Andernfalls ist es NULL.
Bemerkungen
Um einem statischen Steuerelement ein Bild zuzuordnen, muss das Steuerelement den richtigen Stil aufweisen. Die folgende Tabelle zeigt den für jeden Bildtyp erforderlichen Stil.
| Imagetyp | Stil für statische Steuerelemente |
|---|---|
| IMAGE_BITMAP | SS_BITMAP |
| IMAGE_CURSOR | SS_ICON |
| IMAGE_ENHMETAFILE | SS_ENHMETAFILE |
| IMAGE_ICON | SS_ICON |
Wichtig
In Version 6 der Microsoft Win32-Steuerelemente war eine Bitmap, die mithilfe der STM_SETIMAGE Nachricht an ein statisches Steuerelement übergeben wurde, dieselbe Bitmap, die von einer nachfolgenden STM_SETIMAGE-Nachricht zurückgegeben wurde. Der Client ist dafür verantwortlich, alle an ein statisches Steuerelement gesendeten Bitmaps zu löschen.
Wenn unter Windows XP die in der STM_SETIMAGE Meldung übergebene Bitmap Pixel mit ungleich null Alpha enthält, nimmt das statische Steuerelement eine Kopie der Bitmap an. Diese kopierte Bitmap wird von der nächsten STM_SETIMAGE Meldung zurückgegeben. Der Clientcode kann die an das statische Steuerelement übergebenen Bitmaps unabhängig nachverfolgen. Wenn die von STM_SETIMAGE Nachrichten zurückgegebenen Bitmaps jedoch nicht überprüft und freigegeben werden, werden die Bitmaps kompromittiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|