CapturePageEx

Manipulácia so stránkami

Popis

Táto funkcia "zachytí" stránku. Po zachytení možno stránku kresliť na ďalšie stránky. To je užitočné pri spájaní rôznych stránok alebo pri umiestňovaní viacerých pôvodných stránok na inú stránku (impozícia). Zachytená stránka sa z dokumentu odstráni. Ak má mať stránka v dokumente zostať, musíte vytvoriť prázdnu stránku a zachytenú stránku nakresliť na ňu

Okrem toho, keďže dokument musí mať kedykoľvek aspoň jednu stránku, nie je možné zachytiť stránku, ak je jedinou stránkou v dokumente. V takom prípade musíte pred zachytením existujúcej stránky pridať novú prázdnu stránkuCapturePageEx odstráni zachytenú stránku z jej aktuálneho dokumentu; na zachovanie zdrojovej stránky alebo jej import z iného otvoreného dokumentu použite

ImportPageAsFormXObjectAko obmedzujúci obdĺžnik zachytenej stránky sa použije "media box" stránky. Funkcia CapturePageEx sa dá použiť v prípadoch, keď sa má namiesto toho použiť "crop box" stránky

Ako ohraničujúci obdĺžnik zachytenej strany sa používa "media box" strany. Funkciu CapturePageEx možno použiť v prípadoch, keď sa má namiesto toho použiť "crop box" strany.

Syntax

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);

Parametre

PageČíslo stránky na zachytenie. Prvá stránka v dokumente je stránka 1
Options0 = Ako obmedzujúci obdĺžnik použije media box stránky 1 = Ako obmedzujúci obdĺžnik použije crop box stránky, ak existuje, inak media box 2 = Ako obmedzujúci obdĺžnik použije bleed box stránky, ak existuje, inak crop box 3 = Ako obmedzujúci obdĺžnik použije trim box stránky, ak existuje, inak crop box 4 = Ako obmedzujúci obdĺžnik použije art box stránky, ak existuje, inak crop box

Návratové hodnoty

0Zadaná stránka neexistuje alebo je jedinou stránkou v dokumente
Non-zeroID procesu zachytenia. Toto ID sa musí odovzdať funkcii DrawCapturedPage