GetPaletteEntries

【勇芳软件工作室】汉化HomePreviousNext

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