GetPaletteEntries函数从给定的逻辑调色板中检索指定范围的调色板条目。
UINT GetPaletteEntries(
HPALETTE 【HPAL】, | //逻辑调色板的句柄 |
UINT 【iStartIndex】, | //第一个条目检索 |
UINT 【的nentries】, | //要检索的条目数 |
LPPALETTEENTRY 【LPPE】 | //数组接收条目的地址 |
); |
参数
【HPAL】
标识逻辑调色板。
【iStartIndex】
指定要检索的逻辑调色板中的第一个条目。
【的nentries】
指定要检索的逻辑调色板中的条目数。
【LPPE】
指向PALETTEENTRY结构的数组以接收调色板条目。数组必须至少包含与【的nentries】参数指定的结构相同的结构。
返回值
如果函数成功并且逻辑调色板的句柄是有效的指针(非NULL),则返回值是从逻辑调色板检索的条目数。如果函数成功并且逻辑调色板的句柄为NULL,则返回值是给定调色板中的条目数。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。
如果【的nentries】参数指定的调色板中存在的条目多于存在,则PALETTEENTRY结构的其余成员不会更改。
也可以看看
GetDeviceCaps, GetSystemPaletteEntries, SetPaletteEntries, PALETTEENTRY