GdiEndPageEMF 関数 (winppi.h)
GdiEndPageEMF 関数は、EMF 形式の印刷ジョブの物理ページに対する EMF 再生操作を終了します。
構文
BOOL GdiEndPageEMF(
HANDLE SpoolFileHandle,
DWORD dwOptimization
);
パラメーター
SpoolFileHandle
呼び出し元から提供されたスプール ファイル ハンドル。 GdiGetSpoolFileHandle の以前の呼び出しによって取得されます。
dwOptimization
呼び出し元が指定したフラグ。 次のフラグが定義されています。
EMF_PP_COLOR_OPTIMIZATION
色の最適化を有効にします。 詳細については、「解説」を参照してください。
戻り値
操作が成功した場合、関数は TRUE を返します。 それ以外の場合、関数は FALSE を返し、 GetLastError を呼び出すことでエラー コードを取得できます。
注釈
GdiEndPageEMF 関数は、印刷プロセッサの PrintDocumentOnPrintProcessor 関数内で使用するために、gdi32.dll によってエクスポートされます。
GdiEndPageEMF 関数は、物理ページの処理を終了し、プリンターから取り出します。 印刷プロセッサは、次の場合 に GdiEndPageEMF を呼び出す必要があります。
- GdiPlayPageEMF を呼び出して、適切な数のドキュメント ページを物理ページに配置した後。 GdiPlayPageEMF は実際にはデバイス コンテキストで印刷されるのではなく、物理ページに印刷されるテキストとグラフィックスを記述するデータ構造を準備します。 GdiEndPageEMF が呼び出されると、テキストとグラフィックスがデバイス コンテキストに出力されます。
- GdiGetDevmodeForPage の呼び出しで、ドキュメント ページの DEVMODEW 構造体が前のページの DEVMODE 構造体と異なることがあります。
色の透かしを生成する Unidrv レンダリング プラグインを作成する場合は、色の最適化によって、白黒のドキュメントに印刷されるときに、色の透かしが白黒で印刷されることをお勧めします。 色と白黒のドキュメントで色の透かしが正しく印刷されるようにするには、色の最適化を無効にします。
dwOptimization パラメーターによって制御される色の最適化は、ATTRIBUTE_INFO_2またはATTRIBUTE_INFO_3構造体の dwColorOptimization メンバーを設定することによっても制御できます。 この最適化は、Unidrv *ChangeColorModeOnDoc? カラー属性によって制御することもできます (「 色属性」を参照)。
詳細については、「 印刷プロセッサでの GDI 関数の使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | winppi.h (Winppi.h を含む) |
| Library | Gdi32.Lib |
| [DLL] | Gdi32.dll |