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

Статья
08/27/2023

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

Синтаксис

BOOL PlayEnhMetaFile(
  [in] HDC          hdc,
  [in] HENHMETAFILE hmf,
  [in] const RECT   *lprect
);

Параметры

[in] hdc

Дескриптор контекста устройства вывода, на котором будет отображаться изображение.

[in] hmf

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

[in] lprect

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

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

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

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

Когда приложение вызывает функцию PlayEnhMetaFile , система использует кадр рисунка в заголовке расширенного метафайла для сопоставления рисунка с прямоугольником, на который указывает параметр lpRect . (Этот рисунок можно сдвигать или поворачивать, задав преобразование мира на устройстве вывода перед вызовом PlayEnhMetaFile.) Точки вдоль краев прямоугольника включаются в рисунок.

Изображение расширенного метафайла можно обрезать, определив область обрезки на устройстве вывода перед воспроизведением расширенного метафайла.

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

Расширенный метафайл можно встроить в созданный расширенный метафайл, вызвав PlayEnhMetaFile и в результате воспроизведения исходного расширенного метафайла в контексте устройства для нового расширенного метафайла.

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

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

Примеры

Пример см. в разделах Открытие расширенного метафайла и Отображение его содержимого.

Требования


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