共用方式為

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