GetEnhMetaFilePaletteEntries 函数 (wingdi.h)

项目
08/27/2023

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