CapturePage

Маніпулювання сторінками

Опис

Ця функція "захоплює" сторінку. Після захоплення сторінку можна малювати на інших сторінках — це корисно для поєднання різних сторінок чи для розміщення кількох початкових сторінок на одній (imposition). Після захоплення сторінка вилучається з документа. Якщо хочете, щоб сторінка лишилася в документі, створіть порожню сторінку та намалюйте захоплену сторінку на неї

Крім того, оскільки документ завжди має мати принаймні одну сторінку, захопити сторінку неможливо, якщо вона єдина в документі. У такому разі спершу додайте нову порожню сторінку, і вже тоді захопіть наявну

CapturePage не може переміщувати сторінки в інший новий документ, тож усі потрібні сторінки слід об'єднати в один документ до виклику CapturePage. 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-zeroID процесу захоплення. Цей ID треба передати функції DrawCapturedPage