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


CDC::PlayMetaFile

Воспроизводит содержимое заданного метафайла в контексте устройства.

BOOL PlayMetaFile(
   HMETAFILE hMF 
);
BOOL PlayMetaFile(
   HENHMETAFILE hEnhMetaFile,
   LPCRECT lpBounds 
);

Параметры

  • hMF
    Определяет метафайл, которые необходимо воспроизвести.

  • hEnhMetaFile
    Определяет расширенного метафайла.

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

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

Ненулевой если функция успешно; в противном случае – значение 0.

Заметки

Метафайл можно воспроизводить любое количество разу.

Вторая версия PlayMetaFile указывающее, изображения, хранящиеся в данной метафайле улучшенный- формата.Когда приложение вызывает вторая версия PlayMetaFile, Windows использует картинную границу улучшенный- в заголовке метафайла для сопоставления рисунок в прямоугольник указанный в параметре lpBounds.(Это изображение может быть срезатьо или вращанный, установив world преобразовать в устройстве вывода перед вызовом PlayMetaFile). Элементы вдоль краев прямоугольника включены в изображении.Изображение обрезается улучшенный- метафайла можно, указав вырезанную область в устройстве вывода перед воспроизведением расширенного метафайла.

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

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

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CancelDC

GetEnhMetaFileHeader

GetEnhMetaFilePaletteEntries

SetWorldTransform

PlayMetaFile

PlayEnhMetaFile

PlayMetaFile