Функция GetWinMetaFileBits (wingdi.h)
Функция GetWinMetaFileBits преобразует записи расширенного формата из метафайла в записи формата Windows и сохраняет преобразованные записи в указанном буфере.
Синтаксис
UINT GetWinMetaFileBits(
[in] HENHMETAFILE hemf,
[in] UINT cbData16,
[out] LPBYTE pData16,
[in] INT iMapMode,
[in] HDC hdcRef
);
Параметры
[in] hemf
Дескриптор расширенного метафайла.
[in] cbData16
Размер буфера в байтах, в который копируются преобразованные записи.
[out] pData16
Указатель на буфер, который получает преобразованные записи. Если lpbBuffer имеет значение NULL, GetWinMetaFileBits возвращает количество байтов , необходимое для хранения преобразованных записей метафайлов.
[in] iMapMode
Режим сопоставления, используемый в преобразованном метафайле.
[in] hdcRef
Дескриптор контекста эталонного устройства.
Возвращаемое значение
Если функция выполняется успешно и указатель буфера имеет значение NULL, возвращаемое значение — это количество байтов, необходимых для хранения преобразованных записей; Если функция выполняется успешно и указатель буфера является допустимым указателем, то возвращаемое значение — это размер данных метафайла в байтах.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Эта функция преобразует расширенный метафайл в метафайл в формате Windows, чтобы его изображение можно было отобразить в приложении, которое распознает старый формат.
Система использует контекст эталонного устройства для определения разрешения преобразованного метафайла.
Функция GetWinMetaFileBits не делает недействительным расширенный дескриптор метафайла. Приложение должно вызывать функцию DeleteEnhMetaFile , чтобы освободить дескриптор, когда он больше не нужен.
Чтобы создать масштабируемый метафайл в формате Windows, укажите MM_ANISOTROPIC в качестве параметра fnMapMode .
Левый верхний угол изображения метафайла всегда сопоставляется с источником эталонного устройства.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |