GdiPlayPageEMF 함수(winppi.h)

GdiPlayPageEMF 함수는 스풀된 인쇄 작업의 한 문서 페이지에 대해 지정된 사각형 내에서 EMF 레코드를 재생합니다.

구문

BOOL GdiPlayPageEMF(
  HANDLE SpoolFileHandle,
  HANDLE hemf,
  RECT   *prectDocument,
  RECT   *prectBorder,
  RECT   *prectClip
);

매개 변수

SpoolFileHandle

GdiGetSpoolFileHandle에 대한 이전 호출에서 가져온 호출자 제공 스풀 파일 핸들입니다.

hemf

GdiGetPageHandle을 호출하여 레코드를 재생할 페이지를 식별하여 가져온 호출자 제공 페이지 핸들입니다.

prectDocument

페이지를 그릴 사각형을 지정하는 RECT 구조체에 대한 호출자 제공 포인터입니다.

prectBorder

페이지의 테두리 사각형(있는 경우)을 지정하는 RECT 구조체에 대한 호출자 제공 포인터입니다. NULL일 수 있습니다.

prectClip

페이지의 클립 영역(있는 경우)의 좌표를 지정하는 RECT 구조체에 대한 호출자 제공 포인터입니다. NULL일 수 있습니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환합니다. 그렇지 않으면 함수가 FALSE를 반환하고 GetLastError를 호출하여 오류 코드를 가져올 수 있습니다.

설명

GdiPlayPageEMF 함수는 인쇄 프로세서의 PrintDocumentOnPrintProcessor 함수 내에서 사용하기 위해 gdi32.dll 의해 내보내집니다.

GdiPlayPageEMF 함수는 인쇄 프로세서가 문서 페이지 또는 문서 페이지의 지정된 사각형 영역을 실제 페이지에 배치하는 수단입니다. GdiPlayPageEMF는 실제로 디바이스 컨텍스트에서 인쇄되지 않고 실제 페이지에 인쇄할 텍스트와 그래픽을 설명하는 데이터 구조를 준비합니다. GdiEndPageEMF가 호출되면 텍스트와 그래픽이 디바이스 컨텍스트에 인쇄됩니다.

인쇄 프로세서는 prectClip 을 사용하여 인쇄할 사각형 영역을 설명하고 prectDocument 를 사용하여 문서 페이지(또는 잘린 영역)가 맞아야 하는 사각형을 설명합니다. prectClip이 NULL이면 전체 문서 페이지가 인쇄됩니다. prectClip의 NULL이 아닌 값의 경우 클립 영역 내의 문서 페이지 부분만 인쇄됩니다. 그런 다음 GdiPlayPageEMF 함수는 문서 페이지(또는 선택한 부분)를 사각형에 맞추는 데 필요한 크기 조정 및 번역 작업을 수행합니다.

prectBorder 매개 변수가 NULL이 아닌 경우 문서 페이지 주위에 그릴 실선 테두리 사각형을 설명합니다. prectBorder가 NULL이면 이러한 테두리가 그려지지 않습니다.

자세한 내용은 인쇄 프로세서에서 GDI 함수 사용을 참조하세요.

요구 사항

추가 정보

GdiEndPageEMF