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


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