CDC::PlayMetaFile 

BOOL PlayMetaFile ( HMETAFILE hMF );

BOOL PlayMetaFile ( HENHMETAFILE hEnhMetaFile, LPCRECT lpBounds );

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

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

Параметры

hMF

Идентифицирует метафайла должны играть.

hEnhMetaFile

Идентифицирует расширенный метафайл.

lpBounds

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

Примечания

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

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

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

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

CDC обзорЧлены класса | Иерархическая схема

See Also    ::CancelDC, ::GetEnhMetaFileHeader, ::GetEnhMetaFilePaletteEntries, ::SetWorldTransform, ::PlayMetaFile, ::PlayEnhMetaFile, ::PlayMetaFile

Index