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

HENHMETAFILE hemf           // обработка расширенного метафайла  );     

Параметры

Hemf

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

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

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

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

Замечания

Приложение может восстановить файл,  вызывая функцию GetEnhMetaFile.

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

HENHMETAFILE CopyEnhMetaFile (

HENHMETAFILE hemfSrc,     // обработка метафайл 

LPCTSTR lpszFile     // адрес строки имени файла

);       

Параметры

HemfSrc

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

LpszFile

Указатель на имя файла предназначения. Если этот параметр пустой, источник метафайла  скопирован в память.

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

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

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

 Замечания

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

Приложения могут использовать метафайлы, записанные в памяти для временных действий.

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

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

HENHMETAFILE GetEnhMetaFile (

LPCTSTR lpszMetaFile          // адрес имени метафайла

);        

Параметры

LpszMetaFile

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

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

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

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

Замечания

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

Windows - формат метафайла  должен быть преобразован в расширенный формат прежде, чем он может быть обработан функцией GetEnhEnhMetaFile . Чтобы преобразовывать файл, используйте функцию SetWinEnhMetaFileBits.

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

Только Windows 95: максимальная длина строки описания для расширенного метафайла  - 16,384 байтов.

Функция SetEnhMetaFileBits создает в памяти расширенный формат метафайла от поступивших данных.

HENHMETAFILE SetEnhMetaFileBits (

UINT cbBuffer,                       // размер буфера

CONST BYTE * lpData          // буфер содержащий данные расширенного метафайла

);       

Параметры

CbBuffer

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

LpData

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

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

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

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

Замечания

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

Функция SetEnhMetaFileBits не принимает метафайл в формате Windows . Чтобы импортировать windows - формат метафайлов, используйте функцию SetWinMetaFileBits.

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

HDC CreateEnhMetaFile (

HDC hdcRef,                          // обработка контекста устройства ссылки

LPCTSTR lpFilename,           // адрес строки имени файла

CONST RECT * lpRect,         // адрес прямоугольника ограничения