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 [僅限傳統型應用程式] |
| 標頭 |
|