RenderPagesToFilesA

レンダリングと印刷

説明

末尾の A は ANSI(char)DLL エントリポイントを示し、ActiveX/COM の表面では Unicode 形式のみ公開される。動作は RenderPagesToFiles と同一で、文字列引数は現在の SetAnsiMode コードページを使って解釈される

PageRanges で指定した選択文書のページを個別の画像ファイルにレンダリングします

この関数は RenderPageToFile および RenderDocumentToFile と同じレンダリング Options 値を受け付けますが、PageRanges では 1,3,7-9、Odd、Even 2-20 のような連続していないページを選択できます

FileName に %p が含まれる場合、そのトークンはソースページ番号に置き換えられます。FileName に %p が含まれない場合、ソースページ番号はファイル拡張子の前に挿入されます

実装では、アクティブなレンダラーが対応している場合に選択ページリスト全体で 1 つのレンダラーを再利用します。これにより、ページごとに RenderPageToFile を 1 回呼び出すセットアップコストを回避できます

構文

Delphi

Function DLRenderPagesToFilesA(InstanceID: Integer; DPI: Double; PageRanges: PAnsiChar; Options: Integer; FileName: PAnsiChar): Integer;

DLL

int DLRenderPagesToFilesA(int InstanceID, double DPI, const char * PageRanges, int Options, const char * FileName);

パラメータ

DPI各ページのレンダリングに使用する DPI
PageRangesコンマ区切りのページ範囲リスト。空文字列を指定するとすべてのページがレンダリングされます
Options0 = BMP 出力 1 = JPEG 出力 2 = WMF 出力 3 = EMF 出力 4 = EPS 出力 5 = PNG 出力 6 = GIF 出力 7 = TIFF 出力 8 = EMF+ 出力 9 = HTML5 出力 10 = TIFF (G4) 出力
FileName出力ファイル名またはファイル名パターン。ソースページ番号を挿入する位置に %p を使用してください

戻り値

0レンダリングされたページはありません
>0完了または最初のエラーまでに正常にレンダリングされたページ数