ImageList_SetColorTable 函数

  • 项目

设置图像列表的颜色表。

语法

int ImageList_SetColorTable(
  _In_ HIMAGELIST himl,
  _In_ int        start,
  _In_ int        len,
  _In_ RGBQUAD    *prgb
);

parameters

himl [in]

类型： HIMAGELIST

图像列表的句柄。

start [in]

类型： int

一个从零开始的颜色表索引，指定要设置的第一个颜色表条目。

len [in]

类型： int

要设置的颜色表条目数。

prgb [in]

类型： RGBQUAD*

指向包含 DIB 颜色表的新颜色信息的 lenRGBQUAD 结构的数组的指针。

返回值

类型： int

如果函数成功，则返回函数设置的颜色表条目数。 如果函数失败，则返回值小于或等于 0。

注解

只有使用 ILC_COLOR4 或 ILC_COLOR8 标志创建的图像列表才具有颜色表。 此类图像列表的颜色表通常通过复制添加到列表中的第一个图像的颜色表来自动设置， (例如，通过 ImageList_Add 函数) 该图像是否为 DIB。 如果添加到图像列表中的第一个图像不是 DIB，则半色调调色板的颜色表用于 ILC_COLOR8 图像列表，VGA 颜色表用于 ILC_COLOR4。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
DLL
Comctl32.dll (3.51 或更高版本)

请参阅

颜色表