SetWinMetaFileBits 함수(wingdi.h)

아티클
08/27/2023

SetWinMetaFileBits 함수는 메타파일을 이전 Windows 형식에서 새로운 향상된 형식으로 변환하고 새 메타파일을 메모리에 저장합니다.

구문

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

매개 변수

[in] nSize

Windows 형식 메타파일을 포함하는 버퍼의 크기(바이트)입니다.

[in] lpMeta16Data

Windows 형식 메타파일 데이터를 포함하는 버퍼에 대한 포인터입니다. ( GetMetaFileBitsEx 또는 GetWinMetaFileBits 함수를 사용하여 데이터를 가져온 것으로 가정 합니다 .)

[in] hdcRef

참조 디바이스 컨텍스트에 대한 핸들입니다.

[in] lpMFP

메타파일 그림의 제안된 크기와 그림을 만들 때 사용된 매핑 모드를 포함하는 METAFILEPICT 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 메모리 기반 향상된 메타파일의 핸들입니다.

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

설명

Windows는 참조 디바이스 컨텍스트의 해상도 데이터와 METAFILEPICT 구조의 데이터를 사용하여 그림의 크기를 조정합니다. hdcRef 매개 변수가 NULL인 경우 시스템은 현재 출력 디바이스에 대한 해상도 데이터를 사용합니다. lpmfp 매개 변수가 NULL인 경우 시스템은 MM_ANISOTROPIC 매핑 모드를 사용하여 전체 디바이스 화면에 맞도록 그림의 크기를 조정합니다. METAFILEPICT 구조체의 hMF 멤버는 사용되지 않습니다.

애플리케이션에 향상된 메타파일 핸들이 더 이상 필요하지 않은 경우 DeleteEnhMetaFile 함수를 호출하여 삭제해야 합니다.

이 함수에서 반환된 핸들은 다른 고급 메타파일 함수와 함께 사용할 수 있습니다.

참조 디바이스 컨텍스트가 메타파일을 원래 만든 디바이스와 동일하지 않은 경우 디바이스 단위를 사용하는 일부 GDI 함수가 그림을 올바르게 그리지 못할 수 있습니다.

요구 사항

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