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 实际上不会在设备上下文上打印,而是准备一个数据结构,该结构描述将在物理页上打印的文本和图形, (s) 。 调用 GdiEndPageEMF 时,文本和图形将打印到设备上下文中。

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

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

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

要求

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

另请参阅

GdiEndPageEMF