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

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

  • Статья

Функция PlayMetaFile отображает изображение, хранящееся в заданном метафайле Windows на указанном устройстве.

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

Синтаксис

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

Параметры

[in] hdc

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

[in] hmf

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

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

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

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

Комментарии

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

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

Метафайл в формате Windows можно встроить во второй метафайл в формате Windows, вызвав функцию PlayMetaFile и в результате воспроизведения исходного метафайла в контекст устройства для целевого метафайла.

Эта функция удаляет любой объект, созданный, но не удаленный в метафайле в формате Windows.

Чтобы остановить эту функцию, приложение может вызвать функцию CancelDC из другого потока, чтобы завершить операцию. В этом случае функция возвращает значение FALSE.

Требования

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

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

CancelDC

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

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

SetWinMetaFileBits