ImageList_SetColorTable 函式
設定影像清單的色彩表格。
語法
int ImageList_SetColorTable(
_In_ HIMAGELIST himl,
_In_ int start,
_In_ int len,
_In_ RGBQUAD *prgb
);
參數
-
himl [in]
-
類型： HIMAGELIST
影像清單的控制碼。
-
start [in]
-
類型： int
以零起始的色彩表索引，指定要設定的第一個色彩表格專案。
-
len [in]
-
類型： int
要設定的色彩表格專案數目。
-
prgb [in]
-
類型： RGBQUAD*
lenRGBQUAD結構的陣列指標，其中包含 DIB 色彩資料表的新色彩資訊。
傳回值
類型： int
如果函式成功，它會傳回函式所設定的色彩資料表專案數目。 如果函式失敗，則傳回值小於或等於零。
備註
只有以 ILC_COLOR4 或 ILC_COLOR8 旗標建立的影像清單具有色彩資料表。 例如，透過ImageList_Add函式，如果該影像是 DIB，通常會透過 ImageList_Add) 函式，將第一個影像的色彩資料表複製到清單 (自動設定。 如果第一個新增至影像清單的影像不是 DIB，則半色調調色盤的色彩表格會用於 ILC_COLOR8 影像清單，而 VGA 色彩表格則用於 ILC_COLOR4。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| DLL |
|