GdiEndPageEMF 函式 (winppi.h)

發行項
03/01/2024

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 實際上不會列印在裝置內容上，而是準備一個數據結構，描述要列印在實體頁面上的文字和圖形， (s) 。呼叫 GdiEndPageEMF 時，文字和圖形會列印到裝置內容。
每當呼叫 GdiGetDevmodeForPage 表示文件頁面的 DEVMODEW 結構與上一頁的 DEVMODE 結構不同時。

如果呼叫此函式 並將 dwOptimization 參數設定為 EMF_PP_COLOR_OPTIMIZATION，則會啟用色彩優化。如果 dwOptimization 設定為 0，則不會執行任何優化。啟用色彩優化時，多任務緩衝處理檔案中是否存在色彩會導致多任務緩衝處理檔案以色彩播放;多任務緩衝處理檔案中缺少色彩會導致多任務緩衝處理檔案在單色中播放。

如果您要建立 Unidrv 轉譯外掛程式來產生色彩浮水印，建議您在黑白檔上列印色彩浮水印時，色彩優化會使色彩浮浮浮水印成黑白。若要確保色彩浮水印使用色彩和黑白檔正確列印，請停用色彩優化。

dwOptimization 參數所控制的色彩優化也可以透過設定ATTRIBUTE_INFO_2或ATTRIBUTE_INFO_3結構的 dwColorOptimization 成員來控制。此優化也可以由 Unidrv *ChangeColorModeOnDoc？ 色彩屬性控制 (請參閱色彩屬性) 。

如需詳細資訊，請參閱在列印處理器中使用 GDI 函數。