GdiPlayPageEMF 関数 (winppi.h)

GdiPlayPageEMF 関数は、スプール印刷ジョブの 1 つのドキュメント ページに対して、指定された四角形内の 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 関数は、印刷プロセッサの PrintDocumentOnPrintProcessor 関数内で使用するために、gdi32.dll によってエクスポートされます。

GdiPlayPageEMF 関数は、印刷プロセッサがドキュメント ページまたはドキュメント ページの指定された四角形領域を物理ページに配置する手段です。 GdiPlayPageEMF は実際にはデバイス コンテキストで印刷されるのではなく、物理ページに印刷されるテキストとグラフィックスを記述するデータ構造を準備します。 GdiEndPageEMF が呼び出されると、テキストとグラフィックスがデバイス コンテキストに出力されます。

印刷プロセッサでは 、prectClip を使用して印刷する四角形領域を記述し、 prectDocument を使用してドキュメント ページ (またはクリップ領域) が収まる四角形を記述します。 prectClip が NULL の場合、ドキュメント ページ全体が印刷されます。 prectClip の NULL 以外の値の場合、クリップ領域内のドキュメント ページの部分のみが印刷されます。 次 に、GdiPlayPageEMF 関数は、ドキュメント ページ (または選択した部分) を四角形に収めるために必要なスケーリングと翻訳操作を実行します。

prectBorder パラメーターが NULL 以外の場合は、ドキュメント ページの周囲に描画される実線の罫線の四角形を記述します。 prectBorder が NULL の場合、そのような境界線は描画されません。

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

要件

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

こちらもご覧ください

GdiEndPageEMF