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

Статья
03/13/2024

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

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

Синтаксис

HDC CreateMetaFileA(
  [in] LPCSTR pszFile
);

Параметры

[in] pszFile

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

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

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

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

Если текстовые аргументы должны использовать символы Юникода, используйте функцию CreateMetaFile в качестве функции расширенных символов. Если текстовые аргументы должны использовать символы из кодировки Windows, используйте эту функцию как функцию ANSI.

CreateMetaFile — это функция метафайла в формате Windows. Эта функция поддерживает только 16-разрядные приложения windows, перечисленные в разделе Метафайлы формата Windows. Он не записывает и не воспроизводит функции GDI, такие как PolyBezier, которые не были частью 16-разрядной версии Windows.

Контекст устройства, созданный этой функцией, можно использовать для записи выходных функций GDI в метафайл в формате Windows. Его нельзя использовать с функциями запросов GDI, такими как GetTextColor. Если контекст устройства используется с выходной функцией GDI, возвращаемое значение этой функции становится TRUE , если функция записана, и false в противном случае. При выборе объекта с помощью функции SelectObject записывается только его копия. Объект по-прежнему принадлежит приложению.

Чтобы создать масштабируемый метафайл в формате Windows, запишите выходные данные графики в режиме сопоставления MM_ANISOTROPIC. Файл не может содержать функции, изменяющие источник и экстенты окна просмотра, а также функции, зависящие от устройств, такие как функция SelectClipRgn . После создания метафайл Windows можно масштабировать и отрисовывать в любом формате устройства вывода, определив источник окна просмотра и экстенты изображения перед воспроизведением.

Примечание

Заголовок wingdi.h определяет CreateMetaFile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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