通过

GdiEndPageEMF 函数 （winppi.h）

  • 项目

GdiEndPageEMF 函数结束 EMF 格式打印作业的物理页的 EMF 播放作。

语法

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

参数

SpoolFileHandle

调用方提供的后台处理程序，由先前调用 GdiGetSpoolFileHandle获取。

dwOptimization

调用方提供的标志。 定义了以下标志：

EMF_PP_COLOR_OPTIMIZATION

启用颜色优化。 有关详细信息，请参阅“备注”。

返回值

如果作成功，该函数将返回 true 。 否则，该函数返回 FALSE，可以通过调用 getLastError 来获取错误代码。

言论

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

GdiEndPageEMF 函数结束物理页的处理，并导致它从打印机弹出。 打印处理器应在以下时间调用 GdiEndPageEMF：

  • 通过调用 GdiPlayPageEMF，将适当的文档页数置于物理页面上后。 请注意，GdiPlayPageEMF 实际上不会在设备上下文上打印，而是准备一个数据结构，描述要打印在物理页上的文本和图形。 调用 GdiEndPageEMF 时，文本和图形将打印到设备上下文中。
  • 每当调用 GdiGetDevmodeForPage 指示文档页的 DEVMODEW 结构与上一页的 DEVMODE 结构不同。
如果使用 dwOptimization 参数设置为EMF_PP_COLOR_OPTIMIZATION调用此函数，则会启用颜色优化。 如果 dwOptimization 设置为 0，则不会执行任何优化。 启用颜色优化后，后台处理程序文件中存在颜色会导致后台处理程序文件以颜色播放;后台处理程序文件中缺少颜色会导致在单色中播放后台处理程序文件。

如果要创建 Unidrv 呈现插件以生成颜色水印，建议在黑白文档上打印颜色水印时，颜色优化会导致颜色水印以黑白打印。 若要确保使用颜色和黑白文档正确打印颜色水印，请禁用颜色优化。

dwOptimization 参数控制的颜色优化也可以通过设置 ATTRIBUTE_INFO_2 或 ATTRIBUTE_INFO_3 结构 成员 dwColorOptimization 来控制。 此优化也可以由 Unidrv *ChangeColorModeOnDoc 控制？ 颜色属性（请参阅 颜色属性）。

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

要求

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

另请参阅

GdiPlayPageEMF

GdiStartPageEMF