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 来获取错误代码。

言论

gdi32.dll 导出 GdiPlayPageEMF 函数,以便在打印处理器的 PrintDocumentOnPrintProcessor 函数中使用。

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

打印处理器使用 prectClip 来描述要打印的矩形区域,prectDocument 来描述文档页(或剪裁区域)必须容纳的矩形。 如果 prectClipNULL,则将打印整个文档页。 对于非NULLprectClip的值,将仅打印剪辑区域中的文档页面部分。 然后,GdiPlayPageEMF 函数执行使文档页(或所选部分)适应矩形所需的缩放和翻译作。

prectBorder 参数(如果非NULL)描述要围绕文档页绘制的实线边框矩形。 如果 prectBorderNULL,则不会绘制此类边框。

有关详细信息,请参阅 在打印处理器中使用 GDI 函数

要求

要求 价值
目标平台 普遍
标头 winppi.h (包括 Winppi.h)
Gdi32.Lib
DLL Gdi32.dll

另请参阅

GdiEndPageEMF