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 構造体と異なることがあります。
dwOptimization パラメーターを EMF_PP_COLOR_OPTIMIZATION に設定してこの関数を呼び出すと、色の最適化が有効になります。 dwOptimization が 0 に設定されている場合、最適化は実行されません。 色の最適化を有効にすると、スプール ファイルに色が存在すると、スプール ファイルが色で再生されます。スプール・ファイルに色がない場合、スプール・ファイルはモノクロで再生されます。

色の透かしを生成する Unidrv レンダリング プラグインを作成する場合は、色の最適化によって、白黒のドキュメントに印刷されるときに、色の透かしが白黒で印刷されることをお勧めします。 色と白黒のドキュメントで色の透かしが正しく印刷されるようにするには、色の最適化を無効にします。

dwOptimization パラメーターによって制御される色の最適化は、ATTRIBUTE_INFO_2またはATTRIBUTE_INFO_3構造体の dwColorOptimization メンバーを設定することによっても制御できます。 この最適化は、Unidrv *ChangeColorModeOnDoc? カラー属性によって制御することもできます (「 色属性」を参照)。

詳細については、「 印刷プロセッサでの GDI 関数の使用」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
Header winppi.h (Winppi.h を含む)
Library Gdi32.Lib
[DLL] Gdi32.dll

こちらもご覧ください

GdiPlayPageEMF

GdiStartPageEMF