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 函数由 gdi32.dll 导出，以便在打印处理器的 PrintDocumentOnPrintProcessor 函数中使用。

GdiPlayPageEMF 函数是打印处理器在物理页面上放置文档页或文档页的指定矩形区域的方法。 请注意， GdiPlayPageEMF 实际上不会在设备上下文上打印，而是准备一个数据结构，用于描述 () 打印在物理页上的文本和图形。 调用 GdiEndPageEMF 时，文本和图形将打印到设备上下文。

打印处理器使用 prectClip 描述要打印的矩形区域，使用 prectDocument 描述文档页 (或剪裁区域) 必须适合的矩形。 如果 prectClip 为 NULL，则将打印整个文档页。 对于 prectClip 的非 NULL 值，将仅打印剪辑区域中文档页的部分。 然后 ，GdiPlayPageEMF 函数执行所需的缩放和转换操作，使文档页 (或所选部分) 适合矩形。

prectBorder 参数（如果为非 NULL）描述要围绕文档页面绘制的纯线边框。 如果 prectBorder 为 NULL，则不会绘制此类边框。

有关其他信息，请参阅 在打印处理器中使用 GDI 函数。

要求

要求	值
目标平台	通用
标头	winppi.h (包括 Winppi.h)
Library	Gdi32.Lib
DLL	Gdi32.dll

另请参阅

GdiEndPageEMF