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 來描述檔頁面 (或裁剪) 區域必須符合的矩形。 如果 prectClip 為 NULL，則會列印整個文件頁面。 對於 prectClip 的非 NULL 值，只會列印剪輯區域內的文件頁面部分。 然後，GdiPlayPageEMF 函式會執行調整和轉譯作業，讓文件頁面 (或選取的部分) 放入矩形中。
prectBorder 參數如果不是 NULL，則會描述要在文件頁面周圍繪製的實線框線矩形。 如果 prectBorder 為 NULL，則不會繪製這類框線。
如需詳細資訊，請參閱 在列印處理器中使用 GDI 函數。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | winppi.h (包括 Winppi.h) |
| 程式庫 | Gdi32.Lib |
| Dll | Gdi32.dll |