setDIBColorTable 函数 (wingdi.h)

SetDIBColorTable 函数设置当前选定到指定设备上下文的 DIB 颜色表中的一系列条目中的 RGB (红色、绿色、蓝色) 颜色值。

语法

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

参数

[in] hdc

设备上下文。 必须在此设备上下文中选择 DIB。

[in] iStart

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

[in] cEntries

要设置的颜色表条目数。

[in] prgbq

指向 RGBQUAD 结构数组的指针,其中包含 DIB 颜色表的新颜色信息。

返回值

如果函数成功,则返回值是函数设置的颜色表条目数。

如果函数失败,则返回值为零。

注解

应调用此函数来设置使用 1、4 或 8 bpp 的 DIB 的颜色表。 位图的关联位图信息标头结构的 BitCount 成员。

BITMAPINFOHEADER 结构指定每像素的位数。 与设备无关的位图的 biBitCount 值大于 8 没有颜色表。

位图的关联BITMAPV5HEADER结构的 bV5BitCount 成员指定每像素的位数。 bV5BitCount 值大于 8 的设备独立位图没有颜色表。

Icm: 不执行颜色管理。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

BITMAPINFOHEADER

位图函数

位图概述

CreateDIBSection

DIBSECTION

GetDIBColorTable

GetObject

RGBQUAD