CMetaFileDC::CreateEnhanced

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

Значення, яке повертається

Дескриптор контексту пристрою для Розширений метафайл, у разі успіху; в іншому випадку NULL.

Параметри

pDCRef

Визначає посилання пристрій для Розширений метафайл.

lpszFileName

Вказує на рядок із нульовим характер. Визначає ім'я файлу для Розширений метафайл повинен бути створений. Якщо цей параметр має значення NULL, Розширений метафайл це пам'ять, на основі і його вміст, втратив, коли знищено об'єкт або в :: DeleteEnhMetaFile функція називається.

lpBounds

Пункту до RECT структура даних або об'єкта CRect , який визначає розміри у HIMETRIC одиниць (01 міліметрового кроком у) зображення буде зберігатися в Розширений метафайл.

lpszDescription

Пункту до нуля припинено рядок, який визначає ім'я програми, створені зображення, а також заголовок зображення.

Зауваження

Створює пристрій контекст для на розширений формат метафайлу. Цей DC може використовуватися для зберігання апаратно незалежний малюнок.

Windows використовує пристрій посилання, визначені pDCRef параметр для запису роздільну здатність та одиниць пристрою, на якому зображення спочатку з'явилася. Якщо параметр pDCRef є NULL, він використовує поточного пристрою відображення для посилання.

Лівий та верхній членів RECT структури даних, вказаний параметр lpBounds повинні бути менше, ніж справа і знизу членів, відповідно. Точок вздовж країв прямокутника включені в картині. Якщо lpBounds має значення NULL, інтерфейс графічних пристроїв (GDI) обчислює розміри найменший прямокутник, який можна взяти зображення намальовані застосунком. LpBounds параметр слід вказати, де можливо.

Рядок, який вказав на lpszDescription параметр має містити значення null символ між ім'я програми та ім'я зображення і повинні припинити з два символи null — наприклад, "XYZ графіка Editor\0Bald Eagle\0\0," де \0 є null характер. Якщо lpszDescription має значення NULL, немає відповідного запису в заголовку розширеного метафайлу.

Програми використовують DC, створені цю функцію, щоб зберігати графічні зображення в Розширений метафайл. Маркер виявлення цього постійного струму може бути передана будь-якої функції GDI.

Після того, як застосунок зберігає зображення в Розширений метафайл, його можна відобразити зображення на будь-який пристрій виводу шляхом виклику функції CDC::PlayMetaFile . Під час відображення зображення, Windows використовує для розташування та масштаб зображення, прямокутник, вказував параметра lpBounds та роздільна здатність даних із пристрою посилання. Пристрій контекст, повернутих ця функція містить однакові за замовчуванням атрибути, зв'язані з будь-якого нового DC.

Програми потрібно використовувати в :: GetWinMetaFileBits функцію, щоб перетворити Розширений метафайл на старий формат метафайлу Windows.

Ім'я файлу для Розширений метафайл слід використовувати в.EMF розширення.

Огляд CMetaFileDCЧлени класу | Ієрархічна діаграма

See Also   CMetaFileDC::CloseEnhanced, CDC::PlayMetaFile, ::CloseEnhMetaFile, ::DeleteEnhMetaFile, ::GetEnhMetaFileDescription, ::GetEnhMetaFileHeader, ::GetWinMetaFileBits, ::PlayEnhMetaFile

Index