描述
GetEnhMetaFilePaletteEntries函数从指定的增强型图元文件中检索可选的调色板条目。
C++ 语法
UINT GetEnhMetaFilePaletteEntries( __in HENHMETAFILE hemf, __in UINT cEntries, __out LPPALETTEENTRY lppe ); |
PowerBASIC 语法
FUNCTION GetEnhMetaFilePaletteEntries ( _ BYVAL hemf AS DWORD, _ BYVAL cEntries AS DWORD, _ BYREF lppe AS PALETTEENTRY _ ) AS DWORD |
参数
hemf
[in]处理增强型图元文件。
cEnrtries
[in]指定要从可选调色板检索的条目数。
lppe
[out]指向接收调色板颜色的PALETTEENTRY结构数组的指针。数组必须至少包含与cEntries参数指定的条目相同的结构。
返回值
如果数组指针为NULL并且增强的图元文件包含可选的调色板，则返回值是增强图元文件调色板中的条目数;如果数组指针是一个有效的指针，增强型图元文件包含一个可选的调色板，则返回值是复制的条目数;如果图元文件不包含可选的调色板，返回值为零。否则返回值为GDI_ERROR。
备注
应用程序可以在创建图片并将其存储在图元文件中之前调用CreatePalette和SetPaletteEntries函数，将可选的调色板存储在增强型图元文件中。通过这样做，当图像显示在各种设备上时，应用程序可以实现一致的颜色。
显示存储在增强型图元文件中的图片的应用程序可以调用GetEnhMetaFilePaletteEntries函数来确定是否存在可选调色板。如果是这样，应用程序可以再次调用GetEnhMetaFilePaletteEntries函数来检索调色板条目，然后创建一个逻辑调色板（通过使用CreatePalette函数），将其选择到其设备上下文中（通过使用SelectPalette函数），然后实现它（通过使用RealizePalette函数）。在逻辑调色板已经实现之后，调用PlayEnhMetaFile功能使用其原始颜色显示图片。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）