GetEnhMetaFilePaletteEntries 函数 (wingdi.h)
GetEnhMetaFilePaletteEntries 函数从指定的增强型图元文件检索可选的调色板条目。
语法
UINT GetEnhMetaFilePaletteEntries(
[in] HENHMETAFILE hemf,
[in] UINT nNumEntries,
[out] LPPALETTEENTRY lpPaletteEntries
);
参数
[in] hemf
增强型图元文件的句柄。
[in] nNumEntries
要从可选调色板检索的条目数。
[out] lpPaletteEntries
指向接收调 色板颜色的 PALETTEENTRY 结构数组的指针。 数组必须包含至少与 cEntries 参数指定的条目一样多的结构。
返回值
如果数组指针为 NULL 且增强型图元文件包含可选调色板，则返回值是增强型图元文件的调色板中的条目数;如果数组指针是有效的指针，并且增强型图元文件包含可选的调色板，则返回值是复制的条目数;如果图元文件不包含可选调色板，则返回值为零。 否则，返回值为GDI_ERROR。
注解
在创建图片并将其存储在图元文件中之前，应用程序可以通过调用 CreatePalette 和 SetPaletteEntries 函数，将可选调色板存储在增强型图元文件中。 通过执行此操作，当图片在各种设备上显示时，应用程序可以实现一致的颜色。
显示存储在增强型图元文件中的图片的应用程序可以调用 GetEnhMetaFilePaletteEntries 函数来确定是否存在可选调色板。 如果这样做，应用程序可以再次调用 GetEnhMetaFilePaletteEntries 函数来检索调色板条目，然后使用 CreatePalette 函数) 创建逻辑调色板 (，使用 SelectPalette 函数) 将其选择到其设备上下文 (，然后使用 RealizePalette 函数) 实现它 (。 实现逻辑调色板后，调用 PlayEnhMetaFile 函数使用其原始颜色显示图片。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wingdi.h (包括 Windows.h) |
| Library | Gdi32.lib |
| DLL | Gdi32.dll |