勇芳软件工作室.汉化:  Colors > Color Functions >

GetSystemPaletteEntries

Previous pageReturn to chapter overviewNext page

描述

 

GetSystemPaletteEntries函数从与指定设备上下文(DC)关联的系统调色板中检索一系列调色板条目。

 

C++ 语法

 

UINT GetSystemPaletteEntries(

__in HDC hdc,

__in UINT iStartIndex,

__in UINT nEntries,

__out LPPALETTEENTRY lppe

);

 

PowerBASIC 语法

 

FUNCTION GetSystemPaletteEntries ( _

BYVAL hdc AS DWORD, _

BYVAL iStartIndex AS DWORD, _

BYVAL nEntries AS DWORD, _

BYREF lppe AS PALETTEENTRY _

) AS DWORD

 

参数

 

hdc

 

[in]处理设备上下文。

 

iStartIndex

 

[in]指定要从系统调色板检索的第一个条目。

 

nEntries

 

[in]指定要从系统调色板检索的条目数。

 

lppe

 

[out]指向PALETTEENTRY结构数组的指针,以接收调色板条目。数组必须至少包含与的nentries参数指定的结构相同的结构。如果此参数为NULL,则该函数返回调色板中的条目总数。

 

返回值

 

如果函数成功,则返回值是从调色板检索的条目数。

 

如果函数失败,返回值为零。

 

Windows NT / 2000 / XP / Vista / Windows 7:要获取扩展错误信息,请调用GetLastError.

 

备注

 

应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)