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


CMetaFileDC::CreateEnhanced

Создает контекст устройства для улучшенный- формата метафайла.

BOOL CreateEnhanced(
   CDC* pDCRef,
   LPCTSTR lpszFileName,
   LPCRECT lpBounds,
   LPCTSTR lpszDescription 
);

Параметры

  • pDCRef
    Определяет устройство ссылки для расширенного метафайла.

  • lpszFileName
    Указывает на null- завершенной символьную строку.Задает имя файла для расширенного метафайла, который необходимо создать.Если этот параметр NULL, метафайл на основе улучшенной память и его содержимое потеряли при уничтожении объекта или при называется функцию Win32 DeleteEnhMetaFile.

  • lpBounds
    Указатель на структуру данных RECT или объекту CRect, который задает размеры (в единицах HIMETRIC с шагом .01 миллиметров) изображения, сохраняемый в метафайле являются расширенным.

  • lpszDescription
    Указывает на нулевой- завершенной строку, которая задает имя приложения, которое создало изображение, а также имя изображения.

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

Дескриптор контекста устройства для расширенного метафайла, если успешно; в противном случае NULL.

Заметки

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

Windows использует модуль ссылки, заданное параметром pDCRef для записи разрешения и единицы измерения устройства, на котором изначально появилось изображение.Если параметр pDCRefNULL, то он использует текущее дисплейное устройство для ссылки.

Левые верхние и члены структуры данных RECT указанной в параметре lpBounds должны быть меньше правого нижнего элементов и, соответственно.Элементы вдоль краев прямоугольника включены в изображении.Если lpBoundsNULL, то приборный графический интерфейс (GDI) вычисляет измерения наименьшего прямоугольника, который может быть представлен выписанное приложением.Параметр lpBounds должен быть введен, где возможно.

Строка, указанная в параметре lpszDescription должна содержать нуль-символ между именем приложения и именем изображения и должна завершить 2 нуль-символа — например, "Графический редактор XYZ\0Bald Eagle\0\0", где \0 представляет нуль-символ.Если lpszDescriptionNULL, то соответствующая запись улучшенный- в заголовке метафайла.

Контроллер домена приложения, использующие созданный этой функцией, чтобы сохранить изображение графики в метафайле являются расширенным.Дескриптор, определяющий данный контроллер домена, можно передать любой функции GDI.

После того как приложение сохраняет изображение в метафайле, она может отображаться изображение на любом устройстве вывода путем вызова функции CDC::PlayMetaFile.При отображении изображения Windows использует прямоугольник указанный в параметре lpBounds данные из устройства и разрешения references для размещения и масштабирование изображения.Контекст устройства, возвращаемый этой функцией содержит одни и те же атрибуты по умолчанию, связанные с новым контроллером домена.

Приложения должны использовать функцию Win32 GetWinMetaFileBits для преобразования метафайл более старому формат расширенного метафайла Windows.

Имя файла для расширенного метафайла должно использоваться расширение .EMF.

Требования

Header: afxext.h

См. также

Ссылки

Класс CMetaFileDC

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

CMetaFileDC::CloseEnhanced

CDC::PlayMetaFile

CloseEnhMetaFile

DeleteEnhMetaFile

GetEnhMetaFileDescription

GetEnhMetaFileHeader

GetWinMetaFileBits

PlayEnhMetaFile