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

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

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

Замечания

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

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

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

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

Win32-based приложения должны использовать функцию CloseEnhMetaFile.

HMETAFILE CloseMetaFile (

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

);       

Параметры

Hdc

Выделяет метафайл  контекста устройства.

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

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

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

Замечания

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

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

Функция DeleteMetaFile удаляет метафайл или обработку метафайла формата окон.

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

BOOL DeleteMetaFile (

HMETAFILE hmf        // обработка windows - формата метафайла  

);       

Параметры

Hmf

Опознает метафайла .

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

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

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

Замечания

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

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

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

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

HMETAFILE CopyMetaFile (

HMETAFILE hmfSrc,             // обработка  метафайла  

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

);       

Параметры

HmfSrc

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

LpszFile

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

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

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

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

 Замечания

Функция CopyMetaFile поддерживает только приложения,предназначенные для версии 3.x Windows. Она не  записывает или отменяет новые графические функции интерфейса устройства, типа PolyBezier.

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

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

См. Также DeleteMetaFile

Функция GetMetaFile создает обработку, которая опознает формат метафайла .