PlayEnhMetaFile 함수(wingdi.h)
PlayEnhMetaFile 함수는 지정된 고급 형식 메타파일에 저장된 그림을 표시합니다.
구문
BOOL PlayEnhMetaFile(
[in] HDC hdc,
[in] HENHMETAFILE hmf,
[in] const RECT *lprect
);
매개 변수
[in] hdc
그림이 표시될 출력 디바이스에 대한 디바이스 컨텍스트에 대한 핸들입니다.
[in] hmf
향상된 메타파일의 핸들입니다.
[in] lprect
그림을 표시하는 데 사용되는 경계 사각형의 좌표를 포함하는 RECT 구조체에 대한 포인터입니다. 좌표는 논리 단위로 지정됩니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다.
설명
애플리케이션이 PlayEnhMetaFile 함수를 호출할 때 시스템은 고급 메타파일 헤더의 그림 프레임을 사용하여 lpRect 매개 변수가 가리키는 사각형에 그림을 매핑합니다. PlayEnhMetaFile을 호출하기 전에 출력 디바이스에서 월드 변환을 설정하여 이 그림을 전단하거나 회전할 수 있습니다. 사각형 가장자리를 따라 있는 점이 그림에 포함됩니다.
향상된 메타파일을 재생하기 전에 출력 디바이스에서 클리핑 영역을 정의하여 향상된 메타파일 그림을 클리핑할 수 있습니다.
향상된 메타파일에 선택적 색상표가 포함된 경우 애플리케이션은 PlayEnhMetaFile을 호출하기 전에 출력 디바이스에서 색상표를 설정하여 일관된 색을 얻을 수 있습니다. 선택적 팔레트를 검색하려면 GetEnhMetaFilePaletteEntries 함수를 사용합니다.
PlayEnhMetaFile을 호출하고 향상된 원본 메타파일을 디바이스 컨텍스트로 재생하여 향상된 메타파일을 새로 만든 향상된 메타파일에 포함할 수 있습니다.
출력 디바이스 컨텍스트의 상태는 이 함수에 의해 유지됩니다. 향상된 메타파일에서 생성되었지만 삭제되지 않은 개체는 이 함수에 의해 삭제됩니다.
이 함수를 중지하기 위해 애플리케이션은 다른 스레드에서 CancelDC 함수를 호출하여 작업을 종료할 수 있습니다. 이 경우 함수는 FALSE를 반환합니다.
예제
예를 들어 고급 메타파일 열기 및 해당 콘텐츠 표시를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h(Windows.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |