EnumMetaFile 함수(wingdi.h)

아티클
03/13/2024

EnumMetaFile 함수는 각 레코드를 검색하고 지정된 콜백 함수에 전달하여 Windows 형식 메타파일 내에서 레코드를 열거합니다. 애플리케이션에서 제공하는 콜백 함수는 필요에 따라 각 레코드를 처리합니다. 마지막 레코드가 처리되거나 콜백 함수가 0을 반환할 때까지 열거형이 계속됩니다.

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

구문

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다. 이 핸들은 콜백 함수에 전달됩니다.

[in] hmf

Windows 형식 메타파일을 처리합니다.

[in] proc

애플리케이션에서 제공하는 콜백 함수에 대한 포인터입니다. 자세한 내용은 EnumMetaFileProc을 참조하세요.

[in] param

선택적 데이터에 대한 포인터입니다.

반환 값

콜백 함수가 Windows 형식 메타파일의 모든 레코드를 열거하는 경우 반환 값은 0이 아닌 값입니다.

콜백 함수가 Windows 형식 메타파일의 모든 레코드를 성공적으로 열거하지 못하면 반환 값은 0입니다.

설명

Windows 형식 메타파일을 고급 형식 메타파일로 변환하려면 SetWinMetaFileBits 함수를 사용합니다.

EnumMetaFile 함수를 사용하여 하나의 Windows 형식 메타파일을 다른 파일에 포함할 수 있습니다.

요구 사항

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