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

Статья
11/20/2024

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

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

Синтаксис

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

Параметры

[in] unnamedParam1

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

[in] unnamedParam2

Указатель на имя целевого файла. Если этот параметр null, исходный метафайл копируется в память.

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

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

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

Замечания

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

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

Заметка

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

Требования

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

См. также

DeleteMetaFile

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

Обзор метафайлов

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