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

Статья
08/27/2023

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

Синтаксис

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

Параметры

[in] nSize

Размер (в байтах) буфера, содержащего метафайл в формате Windows.

[in] lpMeta16Data

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

[in] hdcRef

Дескриптор контекста эталонного устройства.

[in] lpMFP

Указатель на структуру METAFILEPICT , содержащую предлагаемый размер изображения метафайла и режим сопоставления, который использовался при создании рисунка.

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

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

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

Windows использует данные разрешения контекста эталонного устройства и данные в структуре METAFILEPICT для масштабирования рисунка. Если параметр hdcRef имеет значение NULL, система использует данные разрешения для текущего выходного устройства. Если параметр lpmfp имеет значение NULL, система использует режим сопоставления MM_ANISOTROPIC для масштабирования изображения так, чтобы он соответствовал всей поверхности устройства. Элемент hMF структуры METAFILEPICT не используется.

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

Дескриптор, возвращаемый этой функцией, можно использовать с другими расширенными функциями метафайлов.

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

Требования

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