Функция GetEnhMetaFilePaletteEntries (wingdi.h)

Статья
03/08/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
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll