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 関数の使用」を参照してください。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
ヘッダー | winppi.h (Winppi.h を含む) |
ライブラリ | Gdi32.Lib |
DLL | Gdi32.dll |
関連項目
GdiEndPageEMF の