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

Статья
11/20/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-Format метафайлы. Он не записывает или воспроизводит функции GDI, такие как PolyBezier, которые не были частью 16-разрядных Windows.

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll