Поделиться через


Функция SetMetaFileBitsEx (wingdi.h)

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

Примечание Эта функция предоставляется только для совместимости с метафайлами в формате Windows. Метафайлы расширенного формата предоставляют превосходные функциональные возможности и рекомендуются для новых приложений. Соответствующая функция для метафайла расширенного формата — SetEnhMetaFileBits.
 

Синтаксис

HMETAFILE SetMetaFileBitsEx(
  [in] UINT       cbBuffer,
  [in] const BYTE *lpData
);

Параметры

[in] cbBuffer

Указывает размер метафайла в формате Windows в байтах.

[in] lpData

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

DeleteMetaFile

GetMetaFileBitsEx

Функции метафайлов

Общие сведения о метафайлах

SetEnhMetaFileBits

SetWinMetaFileBits