wglGetLayerPaletteEntries 函数 (wingdi.h)

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

语法

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

另请参阅

COLORREF

LAYERPLANEDESCRIPTOR

Windows 上的 OpenGL

PIXELFORMATDESCRIPTOR

WGL 函数

wglDescribeLayerPlane

wglRealizeLayerPalette

wglSetLayerPaletteEntries