CapturePageEx
Маніпулювання сторінками
Опис
Ця функція "захоплює" сторінку. Після захоплення сторінку можна малювати на інших сторінках. Це корисно для поєднання різних сторінок або для розміщення понад одної початкової сторінки на іншій (спуску смуг). Після захоплення сторінка вилучається з документа. Якщо потрібно, щоб сторінка залишилася в документі, створіть порожню сторінку та намалюйте захоплену сторінку на порожнійКрім того, оскільки документ завжди має містити принаймні одну сторінку, неможливо захопити сторінку, якщо вона єдина в документі. У цьому разі додайте нову порожню сторінку, перш ніж захоплювати наявнуCapturePageEx вилучає захоплену сторінку з її поточного документа; використовуйте
Крім того, оскільки документ завжди має мати принаймні одну сторінку, захопити сторінку неможливо, якщо вона єдина в документі. У такому разі спершу додайте нову порожню сторінку, і вже тоді захопіть наявну
ImportPageAsFormXObject, щоб зберегти початкову сторінку або імпортувати її з іншого відкритого документаЯк обмежувальний прямокутник захопленої сторінки використовується "media box" сторінки. Функцію CapturePageEx можна застосовувати у випадках, коли замість нього слід використовувати "crop box" сторінки
Крім того, оскільки документ завжди має мати принаймні одну сторінку, захопити сторінку неможливо, якщо вона єдина в документі. У такому разі спершу додайте нову порожню сторінку, і вже тоді захопіть наявну
Синтаксис
Delphi
Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;
ActiveX
Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long
DLL
int DLCapturePageEx(int InstanceID, int Page, int Options);
Параметри
| Page | Номер сторінки для захоплення. Перша сторінка в документі — сторінка 1 |
|---|---|
| Options | 0 = використовувати media box сторінки як обмежувальний прямокутник 1 = використовувати crop box сторінки, якщо він є, інакше media box 2 = використовувати bleed box сторінки, якщо він є, інакше crop box 3 = використовувати trim box сторінки, якщо він є, інакше crop box 4 = використовувати art box сторінки, якщо він є, інакше crop box |
Повернуті значення
| 0 | Указаної сторінки не існує або вона єдина в документі |
|---|---|
| Non-zero | Ідентифікатор процесу захоплення. Цей ідентифікатор потрібно передати функції DrawCapturedPage |