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

Статья
03/04/2024

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

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

Синтаксис

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Параметры

[in] hdc

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

[in] hmf

Обработка метафайла в формате Windows.

[in] proc

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

[in] param

Указатель на необязательные данные.

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

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

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

Требования

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