Поделиться через


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

Функция PlayMetaFileRecord воспроизводит запись метафайла в формате Windows, выполняя функцию интерфейса графического устройства (GDI), содержащуюся в этой записи.

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

Синтаксис

BOOL PlayMetaFileRecord(
  [in] HDC           hdc,
  [in] LPHANDLETABLE lpHandleTable,
  [in] LPMETARECORD  lpMR,
  [in] UINT          noObjs
);

Параметры

[in] hdc

Дескриптор для контекста устройства.

[in] lpHandleTable

Указатель на структуру HANDLETABLE, представляющую таблицу дескрипторов объектов GDI, используемых при воспроизведении метафайла.

[in] lpMR

Указатель на запись метафайла в формате Windows.

[in] noObjs

Количество дескрипторов в таблице дескрипторов.

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

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

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

Комментарии

Чтобы преобразовать метафайл в формате Windows в метафайл расширенного формата, используйте функцию SetWinMetaFileBits .

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

Параметры lpHandletable и nHandles должны совпадать с параметрами, передаваемыми в процедуру обратного вызова EnumMetaFileProc с помощью EnumMetaFile.

Если функция PlayMetaFileRecord не распознает запись, она игнорирует запись и возвращает значение TRUE.

Требования

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

См. также раздел

EnumMetaFile

HANDLETABLE

МЕТАЗАПИСЬ

Функции метафайлов

Общие сведения о метафайлах

PlayMetaFile

SetWinMetaFileBits