GetEnhMetaFilePaletteEntries函数从指定的增强型图元文件中检索可选的调色板条目。
UINT GetEnhMetaFilePaletteEntries(
HENHMETAFILE 【HEMF】, | //处理增强型图元文件 |
UINT 【cEntries】, | //调色板条目数 |
LPPALETTEENTRY 【LPPE】 | //调色板入口数组的地址 |
); |
参数
【HEMF】
识别增强的图元文件。
【cEntries】
指定要从可选调色板检索的条目数。
【LPPE】
指向一系列PALETTEENTRY结构以接收调色板颜色。该数组必须至少包含与【cEntries】参数指定的条目相同的结构。
返回值
如果数组指针为NULL并且增强的图元文件包含可选的调色板,则返回值是增强图元文件调色板中的条目数;如果数组指针是一个有效的指针,增强型图元文件包含一个可选的调色板,则返回值是复制的条目数;如果图元文件不包含可选的调色板,返回值为零。否则返回值为GDI_ERROR。
备注
应用程序可以在创建图片并将其存储在图元文件中之前调用CreatePalette和SetPaletteEntries函数,将可选的调色板存储在增强型图元文件中。通过这样做,当图像显示在各种设备上时,应用程序可以实现一致的颜色。
显示存储在增强型图元文件中的图片的应用程序可以调用GetEnhMetaFilePaletteEntries函数来确定是否存在可选调色板。如果是这样,应用程序可以再次调用GetEnhMetaFilePaletteEntries函数来检索调色板条目,然后创建一个逻辑调色板(通过使用CreatePalette函数),将其选择到其设备上下文中(通过使用SelectPalette函数),然后实现它(通过使用RealizePalette函数)。在逻辑调色板已经实现后,调用PlayEnhMetaFile功能将使用其原始颜色显示图像。
也可以看看
CreatePalette, PALETTEENTRY, PlayEnhMetaFile, RealizePalette, SelectPalette