wglGetLayerPaletteEntries 函数 (wingdi.h)

项目
08/27/2023

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

语法

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

参数

unnamedParam1

类型： HDC

要描述其层平面的窗口的设备上下文。

unnamedParam2

类型： int

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

unnamedParam3

类型： int

要检索的第一个调色板条目。

unnamedParam4

类型： int

要检索的调色板条目数。

unnamedParam5

类型： COLORREF*

包含调色板 RGB 颜色值的结构的数组。数组必须包含至少与 cEntries 指定的结构数量一样多。

返回值

类型： int

如果函数成功，则返回值是窗口指定层平面的调色板中设置的条目数。

如果函数失败或未选择像素格式，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

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

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

要求

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