GetEnhMetaFilePaletteEntries

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

GetEnhMetaFilePaletteEntries函数从指定的增强型图元文件中检索可选的调色板条目。

UINT GetEnhMetaFilePaletteEntries(

HENHMETAFILE 【HEMF】,//处理增强型图元文件
UINT 【cEntries】,//调色板条目数
LPPALETTEENTRY 【LPPE】//调色板入口数组的地址
); 

参数

【HEMF】

识别增强的图元文件。

【cEntries】

指定要从可选调色板检索的条目数。

【LPPE】

指向一系列PALETTEENTRY结构以接收调色板颜色。该数组必须至少包含与【cEntries】参数指定的条目相同的结构。

返回值

如果数组指针为NULL并且增强的图元文件包含可选的调色板,则返回值是增强图元文件调色板中的条目数;如果数组指针是一个有效的指针,增强型图元文件包含一个可选的调色板,则返回值是复制的条目数;如果图元文件不包含可选的调色板,返回值为零。否则返回值为GDI_ERROR。

备注

应用程序可以在创建图片并将其存储在图元文件中之前调用CreatePaletteSetPaletteEntries函数,将可选的调色板存储在增强型图元文件中。通过这样做,当图像显示在各种设备上时,应用程序可以实现一致的颜色。

显示存储在增强型图元文件中的图片的应用程序可以调用GetEnhMetaFilePaletteEntries函数来确定是否存在可选调色板。如果是这样,应用程序可以再次调用GetEnhMetaFilePaletteEntries函数来检索调色板条目,然后创建一个逻辑调色板(通过使用CreatePalette函数),将其选择到其设备上下文中(通过使用SelectPalette函数),然后实现它(通过使用RealizePalette函数)。在逻辑调色板已经实现后,调用PlayEnhMetaFile功能将使用其原始颜色显示图像。

也可以看看

CreatePalette, PALETTEENTRY, PlayEnhMetaFile, RealizePalette, SelectPalette