CreateEnhMetaFileA 함수(wingdi.h)

아티클
08/27/2023

CreateEnhMetaFile 함수는 향상된 형식 메타파일을 위한 디바이스 컨텍스트를 만듭니다. 이 디바이스 컨텍스트를 사용하여 디바이스 독립적 그림을 저장할 수 있습니다.

구문

HDC CreateEnhMetaFileA(
  [in] HDC        hdc,
  [in] LPCSTR     lpFilename,
  [in] const RECT *lprc,
  [in] LPCSTR     lpDesc
);

매개 변수

[in] hdc

향상된 메타파일을 위한 참조 디바이스에 대한 핸들입니다. 이 매개 변수는 NULL일 수 있습니다. 자세한 내용은 비고를 참조하세요.

[in] lpFilename

만들 고급 메타파일의 파일 이름에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 향상된 메타파일은 메모리 기반이며 DeleteEnhMetaFile 함수를 사용하여 삭제할 때 해당 내용이 손실됩니다.

[in] lprc

향상된 메타파일에 저장할 그림의 차원(.01밀리미터 단위)을 지정하는 RECT 구조체에 대한 포인터입니다.

[in] lpDesc

그림을 만든 애플리케이션의 이름과 그림 제목을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 자세한 내용은 비고를 참조하세요.

반환 값

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

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

설명

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

시스템은 hdcRef 매개 변수로 식별된 참조 디바이스를 사용하여 사진이 원래 나타난 디바이스의 해상도와 단위를 기록합니다. hdcRef 매개 변수가 NULL인 경우 참조를 위해 현재 디스플레이 디바이스를 사용합니다.

lpRect 매개 변수가 가리키는 RECT 구조체의 왼쪽 및 위쪽 멤버는 각각 오른쪽 및 아래쪽 멤버보다 작아야 합니다. 사각형 가장자리를 따라 있는 점이 그림에 포함됩니다. lpRect가 NULL인 경우 GDI(그래픽 디바이스 인터페이스)는 애플리케이션에서 그린 그림을 둘러싸는 가장 작은 사각형의 크기를 계산합니다. 가능한 경우 lpRect 매개 변수를 제공해야 합니다.

lpDescription 매개 변수가 가리키는 문자열은 애플리케이션 이름과 그림 이름 사이에 null 문자를 포함해야 하며 두 개의 null 문자(예: "XYZ Graphics 편집기\0Bald Eagle\0\0")로 종료해야 합니다. 여기서 \0은 null 문자를 나타냅니다. lpDescription이 NULL인 경우 enhanced-metafile 헤더에 해당 항목이 없습니다.

애플리케이션은 이 함수에서 만든 디바이스 컨텍스트를 사용하여 그래픽 그림을 향상된 메타파일에 저장합니다. 이 디바이스 컨텍스트를 식별하는 핸들은 모든 GDI 함수에 전달될 수 있습니다.

애플리케이션이 향상된 메타파일에 그림을 저장한 후 PlayEnhMetaFile 함수를 호출하여 모든 출력 디바이스에 그림을 표시할 수 있습니다. 그림을 표시할 때 시스템은 lpRect 매개 변수가 가리키는 사각형과 참조 디바이스의 해상도 데이터를 사용하여 그림을 배치하고 크기를 조정합니다.

이 함수에서 반환된 디바이스 컨텍스트에는 새 디바이스 컨텍스트와 연결된 동일한 기본 특성이 포함됩니다.

애플리케이션은 GetWinMetaFileBits 함수를 사용하여 향상된 메타파일을 이전 Windows 메타파일 형식으로 변환해야 합니다.

향상된 메타파일의 파일 이름은 .emf 확장명을 사용해야 합니다.

예제

예제는 향상된 메타파일 만들기를 참조하세요.

참고

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

요구 사항

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