Функции GDI Win-32, страница 17

LPCTSTR lpDescription         // адрес необязательной строки описания 

);       

Параметры

HdcRef

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

LpFilename

Указатель на имя файла  для  расширенного метафайла , который будет создан.

LpRect

Указатель на структуру RECT, определяющую размер (в единицах  .01 миллиметр) изображения, которая будет записана в расширенном метафайле.

LpDescription

Указатель на строку, определяющую имя приложения, которое создавало изображение, а также имя изображения.

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

Если функция выполнена успешно, возвращаемое значение - обработка контекста устройства для  расширенного метафайла .

Если функция выполнена неуспешно, возвращаемое значение нулевое

Замечания

Там, где элементы текста должны использовать символы Unicode, используйте эту функцию как функцию широкого назначения. Там, где элементы текста должны использовать символы от Windows  3.x , используйте ее как функция ANSI.

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

Левые и высшие члены структуры RECT, указанные параметром lpRect должны быть меньше чем правые и лежащие в основании члены, соответственно. Точки по граням прямоугольника включены в изображение. Если lpRect пустой, графический интерфейс устройства (GDI) вычисляет размеры самого маленького прямоугольника, который окружает изображение. LpRect параметр нужно обеспечить где возможно.

Строка, указанная lpDescription параметром должна содержать пустой знак между именем приложения и именем изображения, и должна закончиться с двумя пустыми знаками например, " XYZ Графика Editor\0Bald Eagle\0\0 ", где \0 представляет пустой знак. Если lpDescription пустой, не имеется никакого входа в расширенный метафайл  .

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

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

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

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

Функция CloseEnhMetaFile закрывает  расширенный метафайл  контекста устройства и возвращает обработку, которая опознает расширенный формат метафайла.

HENHMETAFILE CloseEnhMetaFile (

HDC hdc       // обработка  расширенного метафайла  контекста устройства

);       

Параметры

Hdc

Опознает  расширенный метафайл  контекста устройства.

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

Если функция выполнена успешно, возвращаемое значение - обработка  расширенного метафайла .

Если функция выполнена неуспешно, возвращаемое значение нулевое

Замечания

Приложение может использовать обработку расширенного метафайла, возвращенную этой функцией, чтобы исполнить следующие задачи:

·    Вывод изображения, записанного в расширенном метафайле 

·    Создают копии  расширенного метафайла 

·    Перечисляют, редактируют, или копируют индивидуальные отчеты в расширенном  метафайле 

·    Восстанавливают копию  расширенного метафайла  

·    Восстанавливают двоичную копию  расширенного метафайлаа 

·    Перечисляют цвета в необязательной палитре

·    Преобразовывают расширенный формат метафайла  в Windows - формат метафайла 

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