CapturePage
ページ操作
説明
この関数はページを "captures" します。ページをキャプチャすると、他のページ上に描画できます。異なるページを結合したり、複数の元ページを別のページに配置したりする場合 (面付け) に便利です。キャプチャしたページは文書から削除されます。ページを文書内に残す場合は、空白ページを作成して、キャプチャしたページをその空白ページ上に描画する必要があります
また、文書には常に少なくとも 1 ページが必要なため、そのページが文書内の唯一のページである場合はキャプチャできません。この場合、既存ページをキャプチャする前に新しい空白ページを追加する必要があります
CapturePage を使用してページをあるドキュメントから別の新規ドキュメントへ移動することはできないため、CapturePage を呼び出す前に必要なすべてのページを 1 つのドキュメントに結合する必要があります。CaptureID は非表示ページへのポインターにすぎないため、メモリを解放する必要はありません
ページの "media box" をキャプチャ済みページの境界長方形として使用します。代わりにページの "crop box" を使用する場合は CapturePage 関数を使用できます
構文
Delphi
Function TPDFlib.CapturePage(Page: Integer): Integer;
ActiveX
Function PDFlib::CapturePage(Page As Long) As Long
DLL
int DLCapturePage(int InstanceID, int Page);
パラメータ
| Page | キャプチャするページ番号です。文書の最初のページはページ 1 です |
|---|
戻り値
| 0 | 指定したページが存在しないか、ドキュメント内の唯一のページです |
|---|---|
| Non-zero | キャプチャプロセスの ID。この ID は DrawCapturedPage 関数に指定する必要がある |