STM_SETIMAGE訊息

應用程式會傳送 STM_SETIMAGE 訊息，以將新影像與靜態控制項產生關聯。

參數

wParam

指定要與靜態控制項建立關聯的影像類型。 此參數可以是下列其中一個值：

值	意義
IMAGE_BITMAP	點陣圖。
IMAGE_CURSOR	游標。
IMAGE_ENHMETAFILE	增強型中繼檔。
IMAGE_ICON	圖示。

lParam

要與靜態控制項建立關聯的影像控制碼。

傳回值

如果有任何，傳回值是先前與靜態控制項相關聯的影像控制碼;否則為 Null。

備註

若要建立影像與靜態控制項的關聯，控制項必須具有適當的樣式。 下表顯示每個影像類型所需的樣式。

映像類型	靜態控制項樣式
IMAGE_BITMAP	SS_BITMAP
IMAGE_CURSOR	SS_ICON
IMAGE_ENHMETAFILE	SS_ENHMETAFILE
IMAGE_ICON	SS_ICON

重要

在 Microsoft Win32 控制項的第 6 版中，使用 STM_SETIMAGE 訊息傳遞至靜態控制項的點陣圖，是後續 STM_SETIMAGE 訊息所傳回的相同點陣圖。 用戶端會負責刪除傳送至靜態控制項的任何點陣圖。

使用 Windows XP 時，如果傳入 STM_SETIMAGE 訊息的點陣圖包含具有非零 Alpha 的圖元，靜態控制項會取得點陣圖的複本。 這個複製的點陣圖會由下一 個STM_SETIMAGE 訊息傳回。 用戶端程式代碼可以獨立追蹤傳遞至靜態控制項的點陣圖，但如果它未檢查並釋放從 STM_SETIMAGE 訊息傳回的點陣圖，則點陣圖會外泄。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Winuser.h (包含 Windows.h)

另請參閱

STM_GETIMAGE