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

Статья
03/08/2023

Функция EnumEnhMetaFile перечисляет записи в метафайле расширенного формата, извлекая каждую запись и передавая ее в указанную функцию обратного вызова. Функция обратного вызова, предоставляемая приложением, обрабатывает каждую запись по мере необходимости. Перечисление продолжается до тех пор, пока не будет обработана последняя запись или пока функция обратного вызова не возвращает ноль.

Синтаксис

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

Параметры

[in] hdc

Дескриптор для контекста устройства. Этот дескриптор передается функции обратного вызова.

[in] hmf

Дескриптор расширенного метафайла.

[in] proc

Указатель на функцию обратного вызова, предоставляемую приложением. Дополнительные сведения см. в разделе Функция EnhMetaFileProc .

[in] param

Указатель на необязательные данные функции обратного вызова.

[in] lpRect

Указатель на структуру RECT , задающий координаты в логических единицах верхнего левого и нижнего правого углов рисунка.

Возвращаемое значение

Если функция обратного вызова успешно перечисляет все записи в расширенном метафайле, возвращаемое значение будет ненулевым.

Если функция обратного вызова не перечисляет все записи в расширенном метафайле, возвращаемое значение равно нулю.

Если функция обратного вызова вызывает функцию PlayEnhMetaFileRecord , hdc должна определить допустимый контекст устройства. Система использует режим преобразования и сопоставления контекста устройства для преобразования изображения, отображаемого функцией PlayEnhMetaFileRecord .

Функцию EnumEnhMetaFile можно использовать для внедрения одного расширенного метафайла в другой.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll