wglSetLayerPaletteEntries 函数 (wingdi.h)

项目
08/27/2023

在指定设备上下文的给定颜色索引层平面中设置调色板条目。

语法

int wglSetLayerPaletteEntries(
  HDC            unnamedParam1,
  int            unnamedParam2,
  int            unnamedParam3,
  int            unnamedParam4,
  const COLORREF *unnamedParam5
);

参数

unnamedParam1

类型： HDC

要设置其层调色板的窗口的设备上下文。

unnamedParam2

类型： int

覆盖层或底层平面。 iLayerPlane 的正值标识覆盖平面，其中 1 是main平面上的第一个覆盖平面，2 是第一个覆盖平面上的第二个覆盖平面，依此推移。负值标识底层平面，其中 1 是main平面下的第一个底层平面，2 是第一个底层平面下的第二个底层平面，依此。在 PIXELFORMATDESCRIPTOR 结构的 bReserved 成员中提供了覆盖平面和底层平面的数量。

unnamedParam3

类型： int

要设置的第一个调色板条目。

unnamedParam4

类型： int

要设置的调色板条目数。

unnamedParam5

类型： const COLORREF*

指向包含 RGB 颜色信息的 cEntries 结构数组的第一个成员的指针。

返回值

类型： int

如果函数成功，则返回值是窗口指定层平面的调色板中设置的条目数。如果函数失败或未选择像素格式，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

窗口中每个颜色索引平面都有一个大小为 2^n 的调色板，其中 n 是层平面中的位平面数。不能修改调色板的透明索引。

使用 wglRealizeLayerPalette 函数实现层调色板。最初，层调色板仅包含白色条目。

wglSetLayerPaletteEntries 函数不会设置main平面调色板的调色板条目。若要更新main平面调色板，请使用 GDI 调色板函数。

要求


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