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 関数の使用」を参照してください。

必要条件

関連項目

GdiPlayPageEMF の

GdiStartPageEMF の