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

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

  • Статья

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

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

Синтаксис

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Параметры

[in] hMF

Дескриптор метафайла в формате Windows.

[in] cbBuffer

Размер (в байтах) буфера для получения данных.

[out] lpData

Указатель на буфер, который получает данные метафайла. Буфер должен быть достаточно большим, чтобы содержать данные. Если lpvData имеет значение NULL, функция возвращает количество байтов, необходимое для хранения данных.

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

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

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

Комментарии

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

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

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

Требования

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

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

DeleteMetaFile

GetEnhMetaFileBits

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

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

SetMetaFileBitsEx

SetWinMetaFileBits