Шаг 827 - CDC::PlayMetaFile

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

Возвращаемое значение
Отлично от нуля, если функция успешна, иначе 0.

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

Замечания
Показывает содержание определенного метафайла на контексте устройства. Метафайла можно запускать любое число раз.
Вторая версия PlayMetaFile отображает изображение, сохраненное в данном расширенном формате метафайла. Когда вызывается из прикладной программы вторая версия PlayMetaFile, Windows используют кадр рисунка в расширенном - метафайла верхнем колонтитуле, чтобы отобразить изображение на прямоугольник, указанный lpBounds параметром. (Это изображение можно вращаться, устанавливая трансформацию в устройстве вывода перед вызовом PlayMetaFile.) Точки по граням прямоугольника включены в изображение. Изображение расширенного метафайла может быть отсечено, определяя область отсечения в устройстве вывода перед проигрованием расширенного метафайла.
Если расширенный метафайл содержит произвольную палитру, прикладная программа может достигать непротиворечивых цветов, устанавливая цветовую палитру на устройстве вывода перед вызовом второй версией PlayMetaFile. Чтобы получить произвольную палитру, используйте функцию GetEnhMetaFilePaletteEntries. Расширенный метафайл может быть внедрен в недавно созданный расширенный метафайл, вызывая вторую версию PlayMetaFile и запуская источник расширенного метафайла в контекст устройства для нового расширенного метафайла.
Состояние контекста устройства вывода сохраняются этой функцией. Любой созданный объект но не удаленный в расширенном метафале удален этой функцией. Чтобы останавливать эту функцию, прикладная программа может вызывать ::CancelDC из другой нити, чтобы завершить операцию. В этом случае, функция возвращает 0.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 6.02.2002