STM _ SETIMAGE-Nachricht

Eine Anwendung sendet eine STM _ SETIMAGE-Nachricht, um ein neues Image einem statischen Steuerelement 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
_BILDBITMAP
Bitmap.
_BILDCURSOR
Cursor.
IMAGE _ ENHMETAFILE
Erweiterte Metadatei.
_BILDSYMBOL
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 war(sofern vorhanden). Andernfalls ist es NULL.

Bemerkungen

Um ein Bild einem statischen Steuerelement zuzuordnen, muss das Steuerelement den richtigen Stil aufweisen. Die folgende Tabelle zeigt den Stil, der für jeden Bildtyp benötigt wird.

Imagetyp Stil des statischen Steuerelements
_BILDBITMAP SS _ BITMAP
_BILDCURSOR _SS-SYMBOL
IMAGE _ ENHMETAFILE SS _ ENHMETAFILE
_BILDSYMBOL _SS-SYMBOL

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 Bitmaps zu löschen, die an ein statisches Steuerelement gesendet werden.

Wenn bei Windows XP die in der STM _ SETIMAGE-Nachricht übergebene Bitmap Pixel mit einem Alpha ungleich 0 (null) enthält, nimmt das statische Steuerelement eine Kopie der Bitmap an. Diese kopierte Bitmap wird von der nächsten STM _ SETIMAGE-Nachricht zurückgegeben. Der Clientcode kann die an das statische Steuerelement übergebenen Bitmaps unabhängig nachverfolgen. Wenn er jedoch die von STM _ SETIMAGE-Nachrichten zurückgegebenen Bitmaps nicht überprüft und freigibt, gehen die Bitmaps verloren.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

STM _ GETIMAGE