描述
GetPaletteEntries函数从给定的逻辑调色板中检索调色板条目的指定范围。
C++ 语法
UINT GetPaletteEntries( __in HPALETTE hpal, __in UINT iStartIndex, __in UINT nEntries, __out LPPALETTEENTRY lppe ); |
PowerBASIC 语法
FUNCTION GetPaletteEntries ( _ BYVAL hpal AS DWORD, _ BYVAL iStartIndex AS DWORD, _ BYVAL nEntries AS DWORD, _ BYREF lppe AS PALETTEENTRY _ ) AS DWORD |
参数
hpal
[in]处理逻辑调色板。
iStartIndex
[in]指定要检索的逻辑调色板中的第一个条目。
nEntries
[in]指定要检索的逻辑调色板中的条目数。
lppe
[out]指向PALETTEENTRY结构数组的指针，以接收调色板条目。数组必须至少包含与的nentries参数指定的结构相同的结构。
返回值
如果函数成功并且逻辑调色板的句柄是有效的指针（非NULL），则返回值是从逻辑调色板检索的条目数。如果函数成功并且对逻辑调色板的处理为NULL，则返回值是给定调色板中的条目数。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。
如果nEntries参数指定的调色板中存在的条目数量不多，则PALETTEENTRY结构的其余成员不会更改。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）