CreateMetaFileW 함수(wingdi.h)

아티클
08/27/2023

CreateMetaFile 함수는 Windows 형식 메타파일의 디바이스 컨텍스트를 만듭니다.

참고 이 함수는 Windows 형식 메타파일과의 호환성을 위해서만 제공됩니다. 향상된 형식 메타파일은 뛰어난 기능을 제공하며 새 애플리케이션에 권장됩니다. 고급 형식 메타파일의 해당 함수는 CreateEnhMetaFile입니다.

구문

HDC CreateMetaFileW(
  [in] LPCWSTR pszFile
);

매개 변수

[in] pszFile

만들 Windows 형식 메타파일의 파일 이름에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 Windows 형식 메타파일은 메모리 기반이며 DeleteMetaFile 함수를 사용하여 삭제할 때 내용이 손실됩니다.

반환 값

함수가 성공하면 반환 값은 Windows 형식 메타파일의 디바이스 컨텍스트에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다.

설명

텍스트 인수가 유니코드 문자를 사용해야 하는 경우 CreateMetaFile 함수를 와이드 문자 함수로 사용합니다. 텍스트 인수가 Windows 문자 집합의 문자를 사용해야 하는 경우 이 함수를 ANSI 함수로 사용합니다.

CreateMetaFile 은 Windows 형식 메타파일 함수입니다. 이 함수는 Windows 형식 메타파일에 나열된 16비트 Windows 기반 애플리케이션만 지원합니다. 16비트 Windows의 일부가 아닌 PolyBezier와 같은 GDI 함수를 기록하거나 재생하지 않습니다.

이 함수에서 만든 디바이스 컨텍스트를 사용하여 GDI 출력 함수를 Windows 형식 메타파일로 기록할 수 있습니다. GetTextColor와 같은 GDI 쿼리 함수에는 사용할 수 없습니다. 디바이스 컨텍스트를 GDI 출력 함수와 함께 사용하면 함수가 기록되면 해당 함수의 반환 값이 TRUE 가 되고 그렇지 않으면 FALSE 가 됩니다. SelectObject 함수를 사용하여 개체를 선택하면 개체의 복사본만 기록됩니다. 개체는 여전히 애플리케이션에 속합니다.

확장 가능한 Windows 형식 메타파일을 만들려면 그래픽 출력을 MM_ANISOTROPIC 매핑 모드로 기록합니다. 파일에는 뷰포트 원본 및 익스텐트 수정 함수를 포함할 수 없으며 SelectClipRgn 함수와 같은 디바이스 종속 함수를 포함할 수 없습니다. Windows 메타파일을 만든 후에는 재생하기 전에 뷰포트 원본 및 그림의 익스텐션을 정의하여 모든 출력 디바이스 형식으로 크기를 조정하고 렌더링할 수 있습니다.

참고

wingdi.h 헤더는 CREATEMetaFile을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll