EnumEnhMetaFile 함수(wingdi.h)

아티클
08/27/2023

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

구문

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

매개 변수

[in] hdc

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

[in] hmf

향상된 메타파일에 대한 핸들입니다.

[in] proc

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

[in] param

선택적 콜백 함수 데이터에 대한 포인터입니다.

[in] lpRect

그림의 왼쪽 위와 오른쪽 아래 모서리의 좌표(논리 단위)를 지정하는 RECT 구조체에 대한 포인터입니다.

반환 값

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

콜백 함수가 향상된 메타파일의 모든 레코드를 열거하지 못하면 반환 값은 0입니다.

설명

lpRect 매개 변수가 가리키는 사각형 가장자리의 점이 그림에 포함됩니다. hdc 매개 변수가 NULL이면 시스템은 lpRect를 무시합니다.

콜백 함수가 PlayEnhMetaFileRecord 함수를 호출하는 경우 hdc 는 유효한 디바이스 컨텍스트를 식별해야 합니다. 시스템은 디바이스 컨텍스트의 변환 및 매핑 모드를 사용하여 PlayEnhMetaFileRecord 함수에 표시되는 그림을 변환합니다.

EnumEnhMetaFile 함수를 사용하여 하나의 enhanced-metafile을 다른 메타파일 내에 포함할 수 있습니다.

요구 사항


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