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-zero | ID процесу захоплення. Цей ID треба передати функції DrawCapturedPage |