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

Функция GetMetaFile не осуществлена в Win32 API.

Эта функция применяется для совместимости с 16 разрядными версиями Windows. Win32 приложения должны использовать функцию CopyEnhMetaFile.

HMETAFILE GetMetaFile (

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

);       

Параметры

LpszFile

Указатель на строку, которая определяет имя метафайла . (Метафайл  должен уже существовать.)

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

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

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

Замечания

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

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

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

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

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

Эта функция применяется для совместимости с 16 разрядными версиями Windows. Win32 приложения должны использовать функцию SetEnhMetaFileBits.

HMETAFILE SetMetaFileBitsEx (

UINT nSize,                            // размер метафайла 

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

);       

Параметры

NSize

Определяет размер метафайла в байтах.

LpData

Указатель на буфер, содержащий метафайл. (Подразумевается, что данные были получены,  используя функцию GetMetaFileBitsEx.)

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

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

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

Замечания

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

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

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

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

HENHMETAFILE CloseEnhMetaFile (

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

);       

Параметры

Hdc

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

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

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

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

Замечания

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

·    Показывают изображение, записанное в расширенном метафайлк 

·    Создают копии метафайл 

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

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

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

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

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

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

Функция DeleteEnhMetaFile удаляет расширенный метафайл  или обработку метафайла.

BOOL DeleteEnhMetaFile (